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SUMMARY OF TECHNICAL CHANGES 


This revision of the RSX-11M/M-PLUS MCR Operations Manual contains 
changes and additions that document RSX-11M V3.2 and RSX-11M-PLUS 
v1.0. 


TECHNICAL CHANGES COMMON TO RSX~11M AND RSX~-11M-PLUS SYSTEMS 


The following list contains a brief summary of technical changes for 
both operating systems (RSX-11M/M-PLUS) ;: 


1. Revisions to ACNT and SHUTUP 


2. Multiple mounts to insure device access in event of dismount 
operation 


3. Support for group global event flags; MCR Flags command 
4. Stop-bit task synchronization; MCR Stop and Unstop commands 


5. Support for system service messages into error logging files; 
MCR SSM command 


6. New Dismount command keywords: 
/ DEV 
/USER 
/TERM 
7. New features in the Help command that permit indirect 
references to other files and provide the ability to share 
text using a synonym feature 
8. New Initialize volume command procedures 
9. Full duplex terminal driver support in Set command 


10. New Load command keywords: 


/SIZE 
/HIGH 


ll. New Save command keywords: 


/MOU 
/SFILE 


12. New special symbols for the indirect command file processor: 
<DATE> 


<LIBUIC> 
<TIME> 
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13. New directives to the indirect command file processor: 


.~BEGIN 
~DISABLE QUIET 
~ENABLE QUIET 
. ERASE 

- END 

~ EXIT 

.OPENA 

STOP 


TECHNICAL CHANGES FOR RSX~11M~PLUS SYSTEMS 


The following list contains a brief summary of additional enhancements 
to RSX-11M-PLUS: 


1. To perform virtual I/0, the volume must be mounted. The /FOR 
keyword for the Mount command permits access to non-Files-1l 
volumes 


2. Support to set, clear, or display bits in the switch 
register; SWR command (multiprocessing systems only) 


3. New Allocate command keyword: 
/TERM 


4. Additional Dismount command keyword to specify volume access 
rights following a dismount: 


/ LOCK 


5. New keywords to support regions and read-only segments of 
multiuser tasks 


6. New task naming convention to support more than _ 77(8) 
terminals, and /TERM switch to avoid conversions 


7. New keyword (/AFF) to support CPU affinity in multiprocessor 
systems 


8. New keyword (/SYNC) for the Install command to support task 
synchronization in multiprocessor systems 


Note that RSX-11M-PLUS is a new operating system. The preceding list 
summarizes only the major extensions of RSX-11M. RSX~11M-PLUS users 
should read the complete manual to gain operating system insight. For 
example, the RSX-11M-PLUS summary of technical changes omits the fact 
that the system supports multiple processors; it is assumed in the 
summary that the reader realizes RSX-11M-PLUS provides extensions to 
RSX~11M. 
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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M/M-PLUS MCR Operations Manual provides information needed 
to operate and control an RSX-11M/M-PLUS system. It supplies an 
introduction to the basic concepts of MCR and describes the use of MCR 
as the terminal interface with the RSX-11M/M-PLUS operating system. 


The manual identifies two types of users: privileged and 
nonprivileged. MCR provides privileged users functions that control 
and modify system operation as well as functions that permit program 
development and system maintenance. MCR provides nonprivileged users 
only those functions required for program development and local 
maintenance. 


INTENDED AUDIENCE 


The RSX-11M/M-PLUS MCR Operations Manual does not attempt to train 
operators. The manual assumes that the reader is familiar with 


computer operating procedures, both real-time and batch, and that the 
reader has experience operating terminal devices. 


An “operator" is broadly defined as anyone who interfaces directly 
with RSX-1L1M/M-PLUS to perform a task. This broad definition is used 
because of the many and varied settings in which RSX-11M/M-PLUS 
operates; some settings do not require an operator in the 
conventional sense of the term. 


RSX-11S is a compatible subset system of RSX-~11M/M-PLUS. Thus, this 
manual can also be used as a reference document for RSX-11S. 


STRUCTURE OF THE DOCUMENT 


Chapter 1 introduces basic RSX-11M/M-PLUS concepts that pertain to 
system interface. 


Chapter 2 describes procedures that you can use to control the 
operation of your terminal, the execution of your tasks, and (if 
privileged) the operation and resources of the system. The chapter 
also describes many system conventions, such as device and task naming 
conventions. 


Chapter 3 discusses basic concepts of the RSX-11M/M-PLUS file system 
(Files~-11). 


Chapter 4 supplies detailed definitions of all the MCR commands. The 
command definitions are in alphabetical order, by privilege category. 
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Chapter 5 defines indirect command files and describes the MCR 
indirect command file processor. Directives to the indirect command 
file processor appear in alphabetical order. 


Appendix A lists, in alphabetical order, the MCR and Task Termination 
Notification routine (TKTN) messages that can be returned by the 
system. 


Appendix B lists the subset of MCR commands that makes up Basic MCR, 
the subset supported by RSX-115S. 


ASSOCIATED DOCUMENTS 


Other documents related to RSX-11M/M-PLUS are briefly described in the 
respective documentation directories. 


Although the RSX-11M/M-PLUS MCR Operations Manual is primarily 


self-contained, the reader should be familiar with system generation 
options and features to understand the function of this manual in the 
context of RSX-11M/M-PLUS as a whole (see either the RSX-11M or 


RSX-11M-PLUS System Generation and Management Guide). 


CONVENTIONS USED IN THIS DOCUMENT 
User (operator) input appears in red. 


Shading distinguishes RSX-11M-PLUS specific concepts and commands. 
Shading appears at the page or paragraph level only; where explicit 
distinctions are described in the text, material is not shaded. Also, 
distinct examples (one from an RSX-11M system and one from an 
RSX-11M-PLUS system) are labeled, but not shaded. 


A symbol with a one- to three-character abbreviation indicates that 
you press the corresponding key on the terminal, for example, or 


ESC . 


The symbol indicates that you must press the key labeled CTRL 
while you simultaneously press another key: for example, i 
(iru), ‘ In examples, these three control key sequences 


are shown as “Z, “R, “U, respectively, because that is how the system 
echoes them. 


CHAPTER 1 


INTRODUCTION 


This chapter introduces basic RSX-11M/M-PLUS concepts that you should 
be familiar with before you attempt to interact with the operating 
system. 


l.1 TASKS 


The fundamental executable unit of an RSX-11M/M-PLUS system is the 
task. Each task is either privileged or nonprivileged. A privileged 
task has special device and memory access rights that a nonprivileged 
task does not have. Because of their special access rights, 
privileged tasks are potentially hazardous to a running system whereas 
nonprivileged tasks are not. Consult the RSX-11M/M-PLUS Task Builder 
Manual for a complete description of the distinctions between and uses 
of privileged and nonprivileged tasks. 


1.2 PARTITIONS 


A task runs in a predetermined contiguous area of memory called a 
partition. A partition has the following characteristics: 


e A name 

e A defined size 

e A fixed starting address 
e A defined type 


The relationship between a task and the partition in which it runs 
depends on whether the system is mapped or unmapped. RSX-11M-PLUS 
systems are always mapped. In an unmapped RSX-11M system, a task can 
run only in a partition that has the same starting address as the 
partition for which the task image was created by the Task Builder. 
In mapped systems, however, a task can run in any partition that is 
large enough to contain it. (See the RSX-lLIM/M-PLUS Task Builder 
Manual for more information about mapped and unmapped systems.) 


1.2.1 Partition Types 
RSX-11M supports two types of partition in which tasks can execute: 
1. System-controlled 


2. User-controlled 
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In a system-controlled partition, the Executive allocates available 
Space to accommodate as many tasks as possible at any one time. This 
allocation may involve shuffling resident tasks to arrange available 
space into a contiguous block large enough to contain a requested 
task. Only mapped systems support system-controlled partitions. 


A user-controlled partition, however, is exclusively allocated to one 
task at a time. This type of partition is supported by both mapped 


“and unmapped systems under RSX-11M. 


In both types of partitions, the Executive can temporarily move a 
resident task out to a disk (checkpoint) in order to make space 
available for another task. 


1.2.2 Subpartitions 


RSX~11M users can subdivide a user-controlled partition into as many 
as seven non-overlapping subpartitions. Like its parent main 
partition, a subpartition can contain only one task at a time. Since 
the subpartitions occupy the same physical memory as the main 
partition, tasks cannot be simultaneously resident in both the main 
partition and one or more subpartitions. But since each subpartition 
can contain a task, up to seven tasks can potentially run in parallel 
within a pre-empted main partition. 


RSX-11M uses subpartitions to reclaim large storage areas in unmapped 
systems. For example, when a large task that requires a main 
partition is either no longer active or can be pre-empted 
(checkpointed), subpartitioning allows the partition space to be used 
for a number of smaller tasks. 


1.3 MULTIPROGRAMMING 


Tasks compete for system resources (including memory) on the basis of 
priority and resource availability. The priority of a task is 
determined by a number assigned either when the task is created by the 
Task Builder, when it is installed, or when it is run. The number is 
in the range 1 to 250 (decimal), where 250 is the highest priority. 
The highest priority task that has access to and can use all the 
resources it needs has control of the CPU. 


A task often becomes blocked when it requests system services; for 
example, it can block itself as it waits for an I/O transfer to 
complete. While the task is blocked in this way, the Executive looks 
for another task to use the CPU. The chosen task will be the one that 
has the highest priority and has access to all the resources it needs. 


1.4 TASK OPERATION 
You perform four steps to create a task and prepare it for execution: 


1. Enter a program in a Supported source language through an 
editor. 


2. Submit the source code to the appropriate translator 
(compiler), which produces an object file. 
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3. Submit the object file to the Task Builder, which produces a 
task-image file. 


4. Finally, issue an MCR command to install the task image file 
in the system. 


The output files that result from Steps 1, 2, and 3 are each stored on 
a Files-11 volume (see Section 3.1). 


1.4.1 Installing A Task 


When you install a task (by issuing the MCR Install command or a_ form 
of the Run command), the system records a number of task parameters in 
a system-resident list called the System Task Directory (STD). These 
parameters are the name and length of the task, and the address on the 
volume that contains the task image. An installed task is defined as 
a task that has an entry in the STD; it need not be resident in 
memory nor competing for system resources. The system considers a 
task dormant until a request is made for it to be activated. 


The concept of dormant and active tasks is important in a _ real-time 
system. A dormant task uses very little memory (it requires only an 
STD entry and need not be resident); and yet when the task is needed 
to service a real-time event, the Executive quickly and efficiently 
introduces it into active competition for system resources. An 
installed task's STD entry enables this quick response; the STD 
contains all the parameters the system needs to retrieve the requested 
task. 


You can activate an installed, dormant task by issuing the MCR Run 
command; or, another task can activate the task by issuing an 
Executive directive, either RQST$ (Request), RUNS (Run), or SPWNS 
(Spawn). 


When the Executive receives a request to activate a task, it performs 
a series of actions: 


1. Allocates the necessary resources 


2. Places the task in active competition for system resources 
with other resident tasks 


3. Brings the task into memory (when there is space available in 
its partitionl) 


If another task fully occupies the partition in which the new task is 
to be installed and no resident task can be checkpointed, the system 
places the task in a queue of other activated tasks, each waiting for 
space to become available in its partition. Note that the number of 
installed, dormant tasks can, and usually will, far exceed the number 
of active tasks. 


l The Executive can checkpoint a lower priority, checkpointable task, 
if there is one, to make room for the requested task. 
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CHAPTER 2 


PROCEDURES AND CONVENTIONS 


This chapter describes the procedures that permit you to control the 
system from a terminal and discusses operating system conventions. 
The topics are: 


e@ How to operate a terminal (Section 2.1) 
@ How to manage peripheral devices (Section 2.2) 
e How to operate in a multiuser protection system (Section 2.3) 


e How to shut down an RSX-11M/M-PLUS system (Section 2.4) 


2.1 TERMINALS 


2.1.1 Special and Control Characters 


You request the system to control terminal operation by means of 
special character keys and control characters. The relevant special 
character keys are TAB, ESC (or ALT), CR (or RETURN) and RUBOUT (or 
DELETE). In this manual, the symbols Gs), Gx), Ge), and), 
respectively, denote these keys. A control character is produced when 
you type a letter key while pressing CTRL (control). In this manual, 
a control character is written where N is the variable letter 
key. 


When you type ‘ , or , the Executive performs the 
related function and displays “R, “U, or “Z at the issuing terminal. 
When you type , the explicit MCR prompt (MCR>) is displayed. 
(In an RSX-11M-PLUS- system, could, if the terminal is set to 
DCL command recognition, display the DCL prompt (DCL>).}) For other 
control characters, however, the Executive does not return a display. 


Table 2-1 lists all the special character keys and control characters, 
and describes the function of each. 
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Table 2-1 
Special Character Keys and Control Characters ; 


Character Description 


The Cee) (Carriage Return) key terminates a line of 
input and advances the carriage or cursor to position 
l on the next line. 


The Gsc) key terminates a line of input without moving 
the carriage or cursor. When used to terminate an MCR 
command, it suppresses the default MCR prompt. See 
the descriptions of the Open and Run commands (in 
Chapter 4), which have special uses for the Cac) key. 


In systems that have generated the appropriate 
optional facility, the key can be the first 
character in an escape sequence (see the 
RSX~11M/M-PLUS I/O Drivers Reference Manual and the 
description of the SET /ESCSEQ command). 


The Con) key deletes the last character typed at the 
terminal, and further contiguous characters if the key 
is pressed repeatedly. The first (Co) typed deletes a 
character and prints a backslash (\) followed by a 
display of the deleted character. Subsequent 
deletions cause the system to display the deleted 
character. Then, when the operator enters the first 
non-@#) character, the system prints a terminating 
backslash followed by the character typed. 


For example: 


~---First 

! ---Second Co) 
1 t----Third 
! 

! 


!] ----First non-(Ce) 
| 
MISTKAE\EAK\AKE 


The result is MISTAKE. 


On a CRT terminal that supports backspace (a system 
generation option) and has been declared to be a CRT 
by the SET /CRT=ttn: command, the @#) key moves the 
printing position one space to the left and erases any 
character displayed in that position. 


For example, to correct the word MISTKAE, first press 
Cem) three times to erase E, A and K respectively. The 
result is MIST. Then type AKE to get MISTAKE, 


(Note that when (oe) deletes a character in the last 
character position on the right of the screen, the 
last character appears to remain and the next to last 
character disappears. However, the system has in fact 
deleted the last character; you can type for 
verification.) 


(continued on next page) 
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Table 2~-1 (Cont.) 
Special Character Keys and Control Characters 


Description 


typed either as the first character in the line 
or when the terminal is sending data causes MCR to 
prompt for command input with the explicit prompt 
MCR>. (Two special effects of @eU9 are described 
below.) 


If a task is prompting for input when the operator 
types followed by a carriage return, MCR 
displays its explicit prompt, then returns control to 
the interrupted task after receiving a single line of 
input. (An exception arises when an attached task 
specifies an Asynchronous System Trap (AST) for 
unrequested characters. In this case, iru) causes 
an AST to occur thereby gaining the task's attention 
rather than MCR's.) 


See Section 2.1.3 for a more detailed discussion of 
the use of ‘ 


Special effects: 


e If the last character entered at the terminal was 
; additionally performs the function 
of a Grid. 


e If a terminal has been set to "hold screen" mode 
by the /HOLD option of the MCR SET command, 
has the effect of a SET /NOHOLD command; 
that is, disables hold screen mode. (This 
feature is a system generation option in RSX-11M, 
but is always included in an RSX-11M-PLUS 
system. ) 


(or (5) moves the current print position to 
the next horizontal tab stop on the line. The system 
establishes tab stops at every eighth character 
position in the line. 


causes a vertical tab by performing four line 
feeds. 


causes a form feed (but does not perform 
paging). The action appears on the terminal as eight 
line feeds. 


alternately suppresses and resumes the display 
of output at the terminal. The effect of 
depends on the state of the terminal when you type the 
character. 


(continued on next page) 
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Table 2-1 (Cont.) 
Special Character Keys and Control Characters 


Description 


The system controls the function of internally 
by means of a single bit associated with the terminal 
called the disable output bit. When the bit is set, 
the system disables output to the terminal. When the 
bit is cleared, the system resumes the output display. 
Initially, the bit is clear; the first typed 
causes the bit to be set. The next typed then 
clears it again. Thus the net effect of successive 
characters is to alternately stop and start the 
display of output at the terminal. The system 
discards characters directed to a terminal that has 
disabled the display of its output. 


If more than one task is sending output to a terminal, 
it is essential that affect only the task 
delivering output at the time you type z The 
system handles this problem as follows: 


The disable bit is unconditionally cleared for 
attached terminals at: 


e The issuance of an Attach QIO directive 
e The issuance of a Detach QIO directive 


e The issuance of a Write QIO directive that has 
the "clear CTRL/O" subfunction bit set 


A request for input 
The arrival of unsolicited input 
For unattached terminals, the bit is also cleared each 


time a task initiates a request to output to the 
terminal. 


Given these conditions for clearing the disable bit, 
and the fact that entering always complements 
the bit, ‘CARUIO) affects the entering terminal as 
follows: 


At an attached terminal, you can stop output by typing 
F The interrupted output stream will be 
discarded until the next: 
Detach 
Solicited input 


Unsolicited input 


) 


At unattached terminals, stops output only for 
the current buffer, since, at the next I/O initiation, 
the system always clears the disable output bit for 
unattached terminals. 


(continued on next page) 


PROCEDURES AND CONVENTIONS 


Table 2-1 (Cont.) 
Special Character Keys and Control Characters 


Character Description 


typed after a resumes output suspended 
by the previous ‘ (This feature is a system 
generation option in RSX-11M systems, but is always 
included in RSX-11M~PLUS systems.) 


Typing before typing a line terminator causes 
the system to retype the current line on a new line, 
omitting any deleted characters. You can then 
continue typing the remainder of the line. If the 
current line is empty, performs a carriage 
return and line feed. 


For example: 


MISTKAE\EAK\AKE “R 
MISTAKE 


(This feature is a system generation option in RSX=-11M 
systems, but is always included in RSX-11M-PLUS 
systems.) 


Typing while the terminal is receiving output 
suspends additional output until you type or 
: The suspended output is merely delayed, not 
lost (see the description of @ruo ), The combined 
functions of and are convenient when 
using a CRT terminal. (This feature is a system 
generation option.) 


Typing before typing a line terminator deletes 
the current line. The system responds with a carriage 
return and line-feed so that the line can be retyped. 
is echoed as “U. 


Typing clears the terminal type-ahead buffer. 
The type-ahead buffer temporarily stores input 
characters until the terminal driver can pass them to 
the task, When the type-ahead buffer is full, input 
characters are not accepted; type to clear the 
buffer. 


(ua) Typing indicates end~of-file. It is used to 
indicate to system tasks such as MAC, PIP, and TKB 
that the user is finished and the task may exit. 
is echoed as “Z, 


2.1.2 Terminal Characteristics 


In RSX-11M/M-PLUS, a number of terminals can operate concurrently; 
each terminal operates independently of others in the system so that 
each can run one or more different tasks. Thus the PIP utility and 
the MACRO-11 Assembler, for example, can run from different terminals 
at the same time, as long as the required memory is available. 
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If an RSX-11M/M-PLUS system supports multiuser protection (a system 
generation option), each user must log onto a terminal before issuing 
further MCR or task commands (other than the Help command). Section 
2.3.1 describes how to log on and off a terminal in a multiuser 
protection system. 


2.1.2.1 Terminal Privilege - Privileged commands can only be _ issued 
at a privileged terminal. In RSX-11M/M-PLUS systems that support 
multiuser protection, individual users are either privileged or 
nonprivileged. When a user logs on (see Section 2.3.1.1), the 
terminal assumes the privilege status of the user logging on. In 
other RSX-11M/M-PLUS systems, a terminal's privilege status is 
determined initially at system generation. Subsequently, you can use 
the MCR Set command (see Section 4.5) at a privileged terminal to 
modify the privilege status of any other terminal connected to the 
system. 


CAUTION 


Users must take great care when more 
than one terminal is privileged. 
Privileged commands can destructively 
interfere with system operation and with 
each other. 


2.1.2.2 Attached and Unattached Terminals - A terminal is attached 
when all its input and its output are directed to or from a task other 
than MCR. For example, when you invoke a task (such as the text 
editor EDI), the task usually attaches to the terminal so that no 
other task can use the terminal for I/O. When you wish to exit (for 
example, by typing (art) ), the task is detached from the terminal, 
which normally directs subsequent input to MCR. 


Since an attached terminal directs all input to the dedicated task, 
you must either exit from the task or gain MCR's attention before 
attempting to communicate with MCR. (See Section 2.1.3 for a 
description of aS a means of temporarily gaining MCRs 
attention.) 


2.1.2.3 Slave Terminals - You can dedicate a terminal exclusively to 
one or more tasks by issuing an MCR Set command option that sets the 
terminal to slave status. (A special I/O function issued by a _ task 
can also set a terminal to slave status.) The difference between a 
slave terminal and an attached terminal is that a slave terminal 
rejects all unsolicited input, including , but excepting EIRUO) , 
GiRuiQ) , and (irus) . Attached terminals accept certain forms of 
unsolicited input. 


Until you issue another MCR command (or a task issues another special 
I/O function) to delete the slave status, the terminal can only be 
used to communicate with tasks soliciting input from the terminal. 
Slave terminals are often dedicated to real-time applications. 
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2.1.3 Input Prompts 


There are three prompts indicating that a terminal is waiting for 
input: 


1. The default prompt (>) 
2. The task prompt (TSK>) 


3. The MCR prompt (MCR>) 


2.1.3.1 The Default Prompt - A default prompt (the character > in 
position 1 of a new line) indicates that the terminal is ready to 
accept unsolicited input. The term unsolicited implies that no 
specific task has requested input from the terminal. Whatever you 
type in response to the default prompt is normally directed to MCR. 
(An abnormal situation can occur, however, if a task either solicits 
input or attaches to the terminal without displaying a task prompt. A 
soliciting or attached task might receive input that you intended for 
MCR. See Section 2.1.3.2 below.) When MCR receives unsolicited input, 
it identifies, analyzes, and responds appropriately to the input. 
Section 4.2 explains how MCR responds to commands. 


2.1.3.2 The Task Prompt - When MCR activates a task to service a 
command, the task normally prompts: 


tsk> 


where tsk is a 3-character task name. (All DIGITAL system tasks 
identify themselves by a 3-character prompt, and user tasks should do 
the same. ) 


As long aS a prompting task has attached to a terminal, the task 
receives all solicited input entered at the terminal until the task 
detaches, (The terminal discards all unsolicited input.) An 
unattached task, however, encounters the possibility that another task 
could solicit input from the terminal before the operator types a 
response to the prompt. The intervening task would then receive the 
input intended for the task that displayed the prompt. To avoid this 
situation, every task intending to solicit input from a terminal 
should perform the following sequence: 


1. Attach to the terminal 
2. Prompt with a properly formatted identifier (that is, tsk>) 


3. Solicit input (issue a read request) 


2.1.3.3 The MCR Prompt - A terminal always sends to MCR any input 
typed in response to the explicit prompt: 


MCR> 

You can invoke the explicit MCR prompt by typing: 
Gu) 

or (as shown in the Second case described below): 
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( GR does not invoke the MCR prompt in a special case described in 
the second note below. In addition, the description of in 
Table 2-1 describes two further situations in which does not 
obtain the MCR> prompt.) 


The following notes explain various uses of the explicit MCR prompt: 


@ When a terminal is displaying the default prompt (see Section 
2.1.3.1), there is no guarantee that input typed in response 
will be directed to MCR. To ensure that MCR does receive the 
input, press to invoke the MCR prompt. After MCR 
processes the single line of input,+ the terminal resumes 
display of the default prompt. 


e When a terminal is displaying a task prompt (tsk>), the user 
can invoke MCR by typing 


After MCR processes the single line of inputt received, the 
terminal again displays the original task prompt. 


NOTE 


If an attached task specifies an AST on _ receiving 
unsolicited input, causes an AST to occur, 
thereby gaining the task's attention rather than 
MCR's. Consequently, the MCR prompt does not appear. 


e When any terminal is receiving output from a task, you can 
interrupt the output by typing - At the completion of 
the current I/O operation, the terminal displays the explicit 
MCR prompt. After MCR processes the single line of inputl 
directed to it, the system resumes the interrupted output. 


2.2 DEVICES 


A primary function of the operating system is to manage all _. connected 
peripheral devices and thus maintain efficient system performance. 
This section provides basic information needed to manage peripheral 
devices. (Devices within multiuser protection systems are subject to 
a special set of MCR functions, described in Section 2.3.2.) 


During system generation, the operator explicitly describes all 
peripheral devices attached to the system (see the RSX-11M or 


RSX-11M-PLUS System Generation and Management Guide). 


1 The single line of input received by MCR may in fact invoke a_ task 
that proceeds to issue its own prompt. The prompt of the invoked task 
can, however, also be answered by a to invoke the MCR prompt. 
You can then request another task that issues its own prompt, and so 
on, 
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Each device has a unique identifier. The identifier consists of two 
ASCII characters, which form a logical device name, and an optional 1l- 
or 2-digit octal unit number, followed by a colon (:). If you omit 
the optional octal unit number, the system defaults to unit 0. 


Peripheral devices are the actual hardware elements which make up- the 
computer system. Table 2-2 lists the supported RSX-11M/M-PLUS 
peripheral devices and their physical device names. Hardware 
controllers appear in parentheses. An asterisk (*) precedes a device 
that is supported in RSX-11M systems but not in RSX-11M-PLUS systems. 


Pseudo devices must always refer to a real physical devwice. They 
declare this association through the MCR commands Assign or Redirect. 
Pseudo devices provide a shorthand method for referencing real 
physical devices (for example, the pseudo device name SY: refers to 
the system disk) and thus simplify the default structure. Table 2-3 
lists the RSX-11M/M-PLUS pseudo devices. 


Table 2-2 
RSX-11M/M-PLUS Peripheral Devices 


Peripheral Devices Device-unit 


*Analog-to-Digital Converter (ADO1-D) 
(AFC11) 
*Laboratory Peripheral System (AR11) 
Card Reader (CR11) 
Cassette (TA11) 
DECtape (TCl1) 
DECtape II (TU58) 
Disks 
RP04/05/06 disk packs (RH11/RH70/RP04/RP05/RP06) 
RF disks (RF11) 
RKO5 cartridge disks (RK11) 
RKO06/07 cartridge disks (RK611) 
RLOL cartridge disks (RL11) 
RM02/03 disks (RH11/RM02, RH70/RMO3) 
RPO02/03 disks (RP11) 
RSO03/04 disks (RH11/RH70/RS03/RS04) 
RXOl floppy disk (RX11) 


RX02 floppy disk (RX211) 


(continued on next page) 
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Table 2-2 (Cont.) 
RSX-11M/M-PLUS Peripheral Devices 


Peripheral Devices 


*Graphics Display Processor and Scope (VT11/VS60) GRnn: 


*Industrial Control System Local 
and Remote (ICS/ICR-11) 
*Industrial Control Subsystem (DSS11/DRS11) 
Laboratory Peripheral Accelerator (LPA11-K) 
*Laboratory Peripheral System (LPS11) 
Line Printer (LA11/LS11/LP11/LV11) 
Magtapes 
TU45/TU1L6/TE16/TU77 (RH11/RH70/TMO2/TMO3) 
TSO3/TU1LO/TELO (TM11/TMA11/TMB11) 
TS04 (TS11) 
Paper Tape Punch (PC1l1l) 
Paper Tape Reader (PC11/PR11) 
Terminal (DL11/DH11/DJ11/D2Z11) 


Parallel Interprocessor Link (PCL-11B) 
[RSX-11M-PLUS systems] 


TXnn: /RXnn3: 

*Parallel Line Interface (DA11-B) 

*Asynchronous Line Interface (DL11-E) 

Interprocessor Link (DMC) 

*Synchronous Line Interface (DP11) 
(DQ11) 
(DUP11) 
(DU11) 


*Universal Digital Controller (UDC11) 
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Table 2-3 
Permanent Pseudo Devices 


Pseudo Device 


Console Listing 
Console Output 

System Default Device 
Pseudo Input Terminal 
User Default Device 
Null Device 


Virtual Terminal (RSX-11M-PLUS systems) 


A task performs I/O on logical units identified by numbers, called 
Logical Unit Numbers (LUNS), rather than on specific device units. 
Either the programmer or a user assigns each LUN to a specific device 
before the task actively uses the LUN. A LUN assignment can occur at 
one of the three points: 


1. At task build 
2. From within the task at run. time via an Executive directive 
3. Via an MCR command (Reassign) after the task has_ been 


installed and while it is dormant 


Refer to the RSX-1l1M/M-PLUS I/O Drivers Reference Manual or the 
appropriate language User's Guide for more information about logical 
units. 


2.2.1 Pseudo Devices 


A pseudo device is a device unit name that does not correspond to a 
real device until the pseudo device has been redirected. Every task 
in the system, including a system task, needs to communicate with one 
or more of the following pseudo devices: 


Co: Console output device 

CL: Console listing device 

LB: System library device 

TI: Terminal input/output device 
SY: User's system device 


In a given task, LUN 1 may be assigned to CL:, the console listing 
device. When the task references LUN 1, the data is sent to whatever 
device CL: has been redirected to. You can redirect CL: to any 
appropriate device (a line printer or a terminal, for example) without 
affecting the task's execution. 
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A pseudo device redirected to a terminal assumes the privilege status 
of the terminal to which it is redirected. If TT: is a privileged 
terminal, CL: becomes privileged when it is redirected to that 
terminal. But if CL: is subsequently redirected to a nonprivileged 
terminal, it will also become nonprivileged. 


The normal procedure is to redirect CO: to the main operator's 
terminal, and CL: to the line printer. The system automatically 
redirects TI:, the most commonly used pseudo device, depending on how 
a task has been activated: 


e When you issue the MCR Run command to activate a task 
immediately, the system redirects the TI: for that task to 
your terminal. 


e If, in a task, the Executive directive RQST$ or SPWNS 
activates another task, that task's TI: defaults to the TI: 
of the task that issued the directive. 


e If the Executive enters a task into a clock queue for 
activation after a specified interval, the task's TI: 
defaults to CO:. (Both the MCR Run command and the Executive 
directive RUNS allow task activation at a specified interval 
after the command or directive has been issued.) 


2.2.2 The Null Device 


Program testing often requires a data source and a data sink. A data 
source is a device that you can use as a source of unlimited data; 
and a data sink is a device to which you can send unlimited amounts of 
data. These devices are testing mechanisms only, and are not real 
devices. You can use the null device to serve as both data source and 
sink when you test programs. For example, while testing a program 
that normally generates large amounts of printout, you can redirect or 
assign the appropriate LUN to NL:. The system then discards the 
output directed to NL:. When a task reads from NL:, the null device 
returns the code for end of file (IE.EOF); when a task writes to NL:, 
the null device returns the code indicating success (IS.SUC). 


2.2.3 Logical Devices 


Logical device names provide another means by which tasks can maintain 
device independence. (This feature is a system generation option in 
RSX-11M systems, but is always included in RSX-11M-PLUS systems.) A 
logical device name has the same syntax as a real device unit; it 
consists of a 2-character ASCII name (alphabetic) and an optional 1l- 
or 2-digit octal unit number, followed by a colon (:). The 
2-character name can either be equivalent to a standard RSX-11M/M-PLUS 
device name (for example, DK:), or it can consist of two letters 
picked at random (for example, XY:). Before you run ae task that 
refers to a logical device rather than a real device unit, you must 
issue the MCR Assign command to associate the task's logical device 
name with a real device unit (see Section 4.5). 
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Three types of logical device assignments exist in RSX-11M/M-PLUS 
systems: global, local, and login. 


e Global apply to all tasks running in the system, 


e Local apply only to tasks initiated from the terminal used to 
make the assignments. Local assignments override conflicting 
global and login assignments; and the same logical device 
name may be locally assigned to different devices ly different 
terminals. 


e Login apply to systems that support multiuser protection. 
When a user issues the MCR Hello command to log into the 
system, the system automatically establishes one or more login 
logical device assignments. Login assignments override global 
asSignments, but local assignments made from the terminal 
override both login and global assignments. 


If a local assignment overrides an assignment established at 
login, the system reinstates the login assignment when the 
user deassigns the local logical device name. 


The login logical device assignments remain in effect until 
the user logs off or until a privileged terminal deassigns 
them. 


The Executive sets up a logical device table that records all logical 
device assignments and notes whether each assignment is local, login 
or global. The Executive then searches this table every time a task 
refers to a device. A logical name found in the table receives 
precedence over a physical device-unit having the same identifier. 


2.3 MULTIUSER PROTECTION FUNCTIONS 


Multiuser protection, a system generation option, allows an 
RSX-11M/M-PLUS installation to monitor and control individual users of 
the system. 


2.3.1 Logging On And Off A Terminal 


Each user must log onto a terminal before the system accepts further 
MCR or task commands, other than the MCR Help commands. Depending on 
the user's User Identification Code (UIC), the terminal logged onto 
becomes privileged or nonprivileged. 


After completing a session, log off the terminal. The process of 
logging on and off a terminal enables the system to keep accounting 
information about each user, 


The following information is printed on the console terminal following 
each log on/off in the format 


time LOGIN USER lastname [g,m] TTnn: 
time LOGOUT USER [g,m] TTnn: 


The MCR commands that log a user on and off a terminal are Hello and 
Bye. 
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2.3.1.1 The Hello Command —- The parameters to the Hello command are 
the user's UIC (or last name) and a password. The standard format for 
a UIC specifier is [g,m], where g and m are octal numbers from 1 to 
377 that represent group and member numbers, respectively. The Hello 
command allows several UIC formats (see Section 4.5). A privileged 
user has a group number less than or equal to 10 octal. Each UIC has 
an associated l- to 6-character alphanumeric string or password that 
guards against unauthorized access to the system. No one can 
successfully log onto a terminal without supplying the correct 
password for the specified UIC (or last name). 


For example: 


HELLO @ED 
ACCOUNT OR NAME: (301,365) @& 
PASSWORD: 


Note that the Hello command prompts for its parameters when you press 
Cet) after each element of the command string. Alternatively, you can 
type the entire command string on one line, as follows: 


HELLO [30i1;+3651] /BOB 


where BOB (preceded by a mandatory slash) is the password for the 
specified UIC. (The slash is required only when the password is on 
the same line as the UIC or last name.) When the user types a password 
in response to the prompt PASSWORD:, the system does not display the 
typed characters. 


You can also type the command in a mixed format, supplying one element 
of the string on one line and prompting for the other. The procedure 
shown in the following example ensures that the system suppresses’ the 
password: 


HELLO AMBER (Ee? 
PASSWORD: @& 


Note that this example of the Hello command specifies the last name, 
from which the system determines the UIC. 


After you log onto a terminal, the system automatically assigns’ the 
logical name _ SY: to the user’s system disk (a login logical device 
assignment) and then searches the corresponding UFD for a file 
LOGIN.CMD. If found, the file is sent to the indirect processor (see 
Chapter 5). This is especially useful when you issue the same 
commands after each log on. For example, if the user-created 
LOGIN.CMD file contained 


SET /LOWER=TI: 
SET /BUF=TI;:80. 
SET /CRT=TI: 


the following would be displayed each time the user logged on to an 
RSX-11M system: 
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*HEL AMBER 
PASSWORD: 


RSK-11IM BL2G MULTI-USER SYSTEM 


GOOD AFTERNOON 
19-FEB-79 14:06 LOGGED ON TERMINAL TT20:; 


*BLOGIN. CMD 

SET /LOWER=TIs 
>SET /BUF=TI:80, 
°SET /CRT=TI:s 

*@ {EOF > 


If the group number is less than 11, the terminal becomes privileged; 
if the group number is 11 or greater, the terminal assumes 
nonprivileged status (see Section 2.1.2.1). 


2.3.1.2 The Bye Command - When you complete a session at the terminal 
issue the Bye command to log off. This command has no parameters; it 
simply instructs the system to terminate the session. The system 
deletes all local and login logical device assignments, dismounts all 
mounted private devices (see Section 2.3.2), deallocates all private 
devices, aborts all active nonprivileged tasks requested from the 
terminal, displays a termination message, and prevents further use of 
the terminal until another user logs on. 


Example: 
"BYE 


y 


HAVE A GOOD AFTERNOON 


19-FEB-79 2:15 TTS: LOGGED OFF 
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2.3.2 Public, Private, and Unowned Devices 


Systems that support multiuser protection impose special 
characteristics on devices. Devices are public, private, or unowned. 
These characteristics are defined as follows: 


e A public device is a device that anyone logged into the system 
can use. A privileged user can make a device public by 
issuing an MCR Set command keyword. If a privileged user 
mounts a volume on ae public device, all system users can 
access files on the volume. However, since a subsequent 
Dismount command inhibits further file access, each user that 
accesses the volume should issue a Mount command. A public 
device cannot be allocated. 


e A private device is a device that a user has allocated (by 
means of the MCR command Allocate). Only privileged users and 
the owner of a private device can access the device for use 
within the Files-1l file system (see Section 3.1). Ifa 
nonprivileged user allocates a device and mounts a volume on 
the device, other nonprivileged users cannot access’ the 
volume; privileged users can access the volume by issuing a 
Mount command. 


e An unowned device is a device that is neither public nor 
private. If a user, either privileged or nonprivileged, 
mounts a volume on an unowned device, all system users can 
issue subsequent Mount commands and thus access the volume. 
Note that other users cannot access the volume until they 
issue a Mount command. 


Nonprivileged users can only allocate or mount a volume on an 
unowned device. Privileged users can allocate, set public, or 
mount a volume on an unowned device. 


A privileged user can designate any device in the system as a public 
device. The devices most commonly made public are the line printer 
and the system disk. See Section 4.5 for a description of the Set 
command /PUB keyword that makes a device public. 


The MCR Allocate command makes an unowned device the private property 
ef the user issuing the command. Device allocation prevents any other 
nonprivileged user from accessing the device. (Privileged users can 
override a nonprivileged allocation.) When a user accesses a device 
without allocating it, other users can then access and/or allocate 
that device. 


The Deallocate command (see Section 4.5) changes a private device back 
to an unowned device, thereby allowing other users to gain access to 
it. Privileged users can deallocate any private device no matter who 
owns it. Nonprivileged users can deallocate only their own private 
devices. When a user logs off, the system automatically dismounts and 
deallocates any private devices belonging to that user. To encourage 
efficient use of system resources, however, users should deallocate 
devices as soon as the devices are no longer needed 
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RSX-11M grants specific tasks, such as INI, DSC, BAD, and FLX, access 
to unmounted volumes. See the Mount and Dismount command descriptions 
in Chapter 4. 


2.3.3 The Account File Maintenance Program (ACNT) 
RSX-11M/M-PLUS provides an Account File Maintenance Program (ACNT) for 
the creation and maintenance of a multiuser account file. Whenever a 
user tries to log onto a terminal, the system checks the Hello command 
parameters against the account file to determine whether or not the 
user should be allowed access to the system (see Section 2.3.1). The 
account file describes all the UICs that have been authorized for use 
within the multiuser protection system. One UIC can have several 
users, each user having his or her own password. 
ACNT is an interactive program that allows a privileged user to: 

e Create the account file 

e Add new accounts to the file 

e@ Examine individual account entries 

e Modify individual account entries 

e List all the account entries in the file 

e Delete an account from the file 

e Sort the account file 
When activated, ACNT lists the options and requests you to select one. 
Then enter the first letter of the verb that identifies the desired 
option (C for Create, A for Add, and so on). The program responds’ by 
requesting further input or by displaying information according to the 
option selected. Each account entry includes the following 
information: 

e UIC, which serves as an account number 

e Password 

e User's system devicel 

e First name 

e Last name 


e Date and time of the user's most recent login 


e The number of times that the user has logged into the system 


1 When a user logs in successfully, the system assigns the login 
logical name SY: to this device. 
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nonprivileged user can he program “ch 
entry description of his or her password (see Section 2.3.3.8). 


The legal characters for user names are A-Z, 0-9, "S", "'", "eo", and 
oe eae Lower-case characters are converted to upper-case equivalents, 
Any ASCII character greater than 40 (octal) is valid for a password. 


2.3.3.1 Creating the Account File - A multiuser system cannot have 
more than one account file at a time. Create the initial file 
immediately after system generation to allow normal use of the system. 
You should run ACNT under a privileged UIC (uic [1,2] is used by 
convention) to prevent nonprivileged users from accessing the account 
file. The program's create function allocates a file called 
[0,0]RSX11.SYS and sets the file's protection to [RWED,RWED,,]. This 
protection allows file access to privileged users and privileged tasks 
only. 


A privileged user may copy and optionally extend the account file 
(RSX11.SYS) using PIP. The new copy will receive the RSX-11M/M-PLUS 
default file protection, which includes read access for the world. 
The system manager should, therefore, immediately run ACNT. ACNT will 
detect the incorrect protection codes, mark as free any extended area, 
resort the file, and restore proper protection. This prevents 
unauthorized access to ACNT. 


The following example shows how to create the account file: 
>RUN $ACNT 


* ACCOUNT FILE MAINTENANCE PROGRAM * 
QPTIONS ARE: A - ADD, C - CREATE FILE» D - DELETE, E - EXAMINE, 


Lo- LISTs M - MODIFY, S ~ SORT: CTRL/Z -~ EXIT 
ENTER OPTION: C 
ENTER MAXIMUM NUMBER OF ACCOUNTS: ne Ger 


Enter a decimal number (n.) to specify the maximum number of account 
entries to be listed in the file. The system then creates an account 
file large enough to contain that number of entries. If the account 
file proves to be insufficient, additional account file space can be 
obtained by copying the file using PIP and specifying the /BL switch. 
Note that the protection precautions listed above apply in this case. 


2.3.3.2 Adding Account Entries - After you enter the maximum number 
of accounts, ACNT prompts 


ENTER ACCOUNT OR «ESC? FOR OPTIONS ¢ NoN )s 


In this way, ACNT allows you to start adding accounts to the file 
immediately after its creation. To respond, enter either the octal 
group and member numbers of a UIC, separated by a comma (that is g,m), 
or the key to request a list of all the available options. Each 
new account is entered and the file is automatically maintained in 
sorted order by UIC. 
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The following example starts up ACNT and then shows how to add account 
entries to the file. 


*RUN $ACNT 
* ACCOUNT FILE MAINTENANCE PROGRAM * 
OPTIONS ARE: A - ADD+ C - CREATE FILE: D - DELETE, E - EX@MINE> 


Lo - LIST, M - MODIFY: S - SORTs CTRL/Z ~ EXIT 
ENTER OPTION: 4 


ENTER ACCOUNT OR <ESC> FOR OPTIONS ¢( NeN )s3 200 +202 RED 
PASSWORD ( *<=G CHARS. ): BB 

DEFAULT SYSTEM DEVICE ( DDU ): sy @& 

FIRST NAME ( «<=#12 CHARS. ): BOB 

LAST NAME ( ¢=14 CHARS. ): AMBER @ 


UFD SYOOr; [200,202] 


ENTER ACCOUNT OR <ESC> FOR OPTIONS ( NoN ): 200 +203 


+ 


ACNT prompts for each required item of information after you enter the 
UIC group and member numbers. The prompts include the number of 
characters permitted in the password, the first name, and the last 
name. The. default system device prompt requests a device name and 
unit number (optional iff 0). 


After receiving the last name, ACNT issues an MCR UFD command to 
create a directory for the new account on the default system disk. 
ACNT then repeats the prompt: 


ENTER ACCOUNT OR «ESC> FOR OPTIONS ( NoN )s 


You can either continue to add account entries, choose another option, 
or terminate ACNT. 


2.3.3.3 Examining Account Entries - The Examine option displays 
details about individual account entries. After ACNT displays the 
options and the prompt 


ENTER OPTION: 
enter E, and ACNT responds by displaying 
ENTER ACCOUNT OR “ESC? FOR OPTIONS ( NoN )3 


Then type the UIC numbers of the account to be examined. For example: 


OPTIONS ARE: A - ADDy C - CREATE FILE, D ~- DELETE, E - EXAMINE, 
Lo- LISTs M ~ MODIFY+ § ~ SORT, CTRL/Z - EXIT 
ENTER OPTION: €£ 
ENTER ACCOUNT OR “ESC? FOR OPTIONS ( NoN ): 200,202 GE 
C200 +2023 BB BOB AMBER SYOQs 
2/1/79 19:44:46 oot 


ENTER ACCOUNT OR *ESC> FOR OPTIONS ¢( NoN )3 


ACNT displays two lines of information about each entry corresponding 
to the specified account. The first line shows, from left to right, 
the account UIC, password, first name, last name, and default system 
device. The second line consists of the date and time of the 
account's last login, followed by the number of times a user has 
logged into the system with this account since the account file was 
created. After displaying all the entries for the specified UIC, the 
program prompts for another account or for a list of options. 
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If ACNT receives another account number, it displays entry details 
about the specified UIC; ACNT remains in Examine mode until you type 
Cesc) to request a list of options. 


2.3.3.4 Modifying Account Entries - The Modify option allows a 
privileged user to change the password, default system device, first 
name and/or last name of an account. In an RSX-11M-PLUS- system, the 
Modify option also allows you to change the session identifier and the 
account number. (A nonprivileged user can run the ACNT program to 
change the password of his or her own account; see Section 2.3.3.8.) 
For example: 


OPTIONS ARE: A - ADD» C - CREATE FILE+ D - DELETE, E - EXAMINE: 
Lo o- LIST+s M = MODIFY, S - SORT,» E€TRL/Z ~- EXIT 
ENTER OPTION: M 
ENTER ACCOUNT OR <ESC: FOR OPTIONS ( NoN )t 200+ 202 QE 
[200,202] BB BOB AMBER LBOOs 

2/1/78 19:44:46 ooool 


THIS ENTRY 7 CY/NIs Y Ger 
TYPE <ESC> TO LEAVE ENTRY UNCHANGED 
PASSWORD ( «=G CHARS. ): ZUK 


DEFAULT SYSTEM DEVICE ( DDU )s DB1 GD 
WFD DBOL:C200+202]) 


FIRST NAME ( “512 CHARS. ): €80 
LAST NAME (¢ <=14 CHARS. ): €9 
ENTER ACCOUNT OR <ESC? FOR OPTIONS ( NoN ): 


After you specify the account to be modified, the program displays the 
account entry and asks for verification. Type either Y (Yes) or N 
(No) to indicate that the correct account was or was not specified. 
If ACNT receives a negative reply, it searches the file for another 
entry with the same UIC. For example: 


ENTER OPTION: M 


ENTER ACCOUNT OR “ESC? FOR OPTIONS (¢ NeN Ds 2OG+808 
[200,202] BOB AMBER LBOQOs 
O2/12/79 10:36:25 00037 


THIS ENTRY * CY/NI: N 
[200,202] BOB REBMA LBOos 

02/12/79 Brk3125 OO1d5 
THIS ENTRY 7 CY/NI Y¥ 


WHEN ACNT receives a positive reply, it prompts for the entry details, 
requests (Cesc) in response to an item not to be changed, and then 
prompts for each changeable account item. In the first Modify example 
above, the user changes the account's password to ZUK and the default 
system device to DBl:. The program issues an MCR UFD command to 
create a directory for the account on the new system disk, and then 
prompts for the remaining items (first and last names). 


An examination of the [200,202] account might now read: 


L200 +202) 2UK BoB AMBER DBOLs 
2/1/79 19:44:46 gangs 


You can either continue in Modify mode by entering another account, or 
type Cesc) to obtain a list of options. 
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2.3.3.5 Listing All Account Entries - The List option either displays 
on the user's terminal or spools to the line printer all the accounts 
described in the account file. For example: 


OPTIONS ARE: A - ADD+ GC ~ CREATE FILE+ D ~ DELETE: E - EXAMINE, 
Lo- LIST» M - MODIFY,» S$ - SORT, CTRL/Z ~ EMIT 

ENTER OPTION: L 

PRINT PASSWORDS? CY/Ni: N @e 

ALL ACCOUNTS? CY/N1: N 

ENTER GROUP NUMBER (N): 7 GED 

ENTER T ~ TERMINAL OR L - SPOOLED LINEPRINTER: T Ge 


COO7+,001] BOB AMBER SYOOs 
1/30/79 §:32:21 oO1995 

CO07 +002] BOB MBERA LBOOs 
1/29/79 LisSd: 6 O39) 

COO7 290373 BOB BERMA LBOOs 
1/90/79 13: 8:51 go1igs 

C007 +004) BOB ERBMA SYOOs 
2/1/79 9:42: 3 Oo8gg 

COO7 +003] BOB REBMA SYOOs 
2/1/79 9:46:44 O1469 


In this example, ACNT lists the entries of a specific grcup in the 
file (without displaying the passwords) at the terminal. The program 
then displays all its options and requests a choice. 


2.3.3.6 Sorting the Account File - The Sort option sorts the account 
file in ascending order by UIC. For example: 


OPTIONS ARE: A - ADD» C ~ CREATE FILE+ D - DELETE), & - EM@MINEs 
Lo- LIST+ M - MODIFY, S - SORT+ CTRL/Z - EXIT 
ENTER OPTION: S&S 


When the sort is complete, ACNT displays 


OPTIONS ARE: A ~ ADD» C - CREATE FILE» D ~- DELETE, E —~ EXAMINE? 
Lo- LIST+ M - MODIFYs S ~- SORT» CTRL/2? ~ EXIT 
ENTER OPTION: 


and prompts for another option. 


2.3.3.7 Deleting Account Entries - The Delete option eliminates 
individual accounts from the file. For example: 


OPTIONS ARE: A - ADD+ C ~ CREATE FILE: D - DELETE+ E - EXAMINE; 
Lo- LISTs M - MODIFY+s S - SORT, CTRL/Z ~ EXIT 
ENTER OPTION: D 
ENTER ACCOUNT OR <ESC? FOR OPTIONS ( NeN 3: 2BOO.20? GE 
L200;202] BOB AMBER LBOO: 
02/12/79 19:36:25 oo0037 
THIS ENTRY ? CY/NI: N 
L200.202] BOB REBMA LBoo: 
02/12/79 6:23:25 ao14as 
THIS ENTRY ? LY/NI Y GE 
DELETE UFD AND FILES? CY/NiJ: Y QED 
PIP DBOL:C200,2021%,#4*/DE 
*PTP DBO CO,O12002027 ,DIRG*#/DE 


ENTER ACCOUNT OR <ESC> FOR OPTIONS ( NeN )s 
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After you specify the account to be deleted, ACNT displays the account 
entry and requests a Y (yes) or N (no) reply for verification. A 
negative reply causes ACNT to search for another entry with the same 
uc. If the reply is Y for Yes, the program asks if you want to 
delete the account's UFD and other files. Another positive reply 
produces Peripheral Interchange Program (PIP) commands to delete these 
files. If you enter N in response to the deletion query, the 
account's files and UFD are left intact. Remain in Delete mode by 
entering another account, or type Csc)for the option list. 


2.3.3.8 Nonprivileged Account Modifications - A nonprivileged user 
can run the ACNT program to change his or her password; all other 
ACNT options are privileged. For example: 

>RUN ACNT 


* ACCOUNT FILE MAINTENANCE PROGRAM * 


PASSWORD ( <=G6 CHARS. ): BOB 
TYPE <ESC> TO LEAVE ENTRY UNCHANGED 
PASSWORD ( <=G CHARS. ): PSWRD 


OPERATION COMPLETE 


When a nonprivileged user runs the ACNT program, it identifies itself 
and immediately prompts for the password of the user currently logged 
onto the terminal. It then searches the account file for the entry 
that matches the UIC and password. When ACNT locates the correct 
entry, it instructs the user to type Cec) to leave an entry unchanged. 
ACNT then prompts for the new password and changes it whenever the 
user types characters other than (sc) in response to the prompt. The 
prompt shows the maximum character length allowed for a password. 


ACNT displays OPERATION COMPLETE and automatically exits after the 
user terminates the wrong password in response to the initial query. 


To enable this nonprivileged option, the ACNT task must already be 
installed in the system. A nonprivileged user cannot request ACNT by 
the install-run-remove option of the Run command because ACNT is a 
privileged task. 


2.3.3.9 ACNT Error Messages - The ACNT program returns the following 
error messages: 


ACNT -- ACCOUNT ALREADY EXISTS 


Explanation: The user attempted to add an account with a 
UIC and password that are already contained in the account 
file. 


ACNT -- ACCOUNT FILE ALREADY EXISTS 


Explanation: The user attempted to create the account file, 
but the account file already existed. 


ACNT -- ACCOUNT FILE ERROR —- x. 


Explanation: The program detected an I/O error while 
processing the account file. See the IAS/RSX-11l_ I/0 
Operations Reference Manual, Appendix I, for a definition of 
the error code. 
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ACNT -- ACCOUNT FILE FULL 
Explanation: The account file is full; the user cannot add 
further accounts. See the description of the Create command 
for details on how to enlarge the account file. 

ACNT -- CANNOT FIND ACCOUNT 


Explanation: The user attempted to delete, examine, or 
modify an account that does not exist. 


ACNT -- INVALID DEFAULT DEVICE NAME 


Explanation: The default system device specified is either 
not in the system or not a Files-ll device. 


ACNT -- INVALID OPTION 
Explanation: In response to the prompt ENTER OPTION:, the 
user did not specify A, C, D, E, L, M, S, or (Gra , which 
represent valid ACNT options. 

ACNT -- LISTING FILE ERROR 
Explanation: When you use the List option, ACNT opens’ the 
file SY:[current uic] ACCNT.DMP. This message indicates 
that ACNT could not open the file; for example, the device 
was full or it didn't contain a UFD for the current UIC. 

ACNT --- SYNTAX OR COMMAND INPUT ERROR 


Explanation: The user typed an invalid character. Re-enter 
the. correct data, 


ACNT -- WORKFILE - DYN. MEM. EXHAUSTED 
Explanation: There is insufficient dynamic memory. Either 
install the task in a larger partition, or install it with a 
larger increment. 


ACNT —-~ WORKFILE - VIRTUAL STORAGE EXCEEDED 


Explanation: The workfile exceeds virtual memory. 


2.4 THE SHUTUP PROGRAM 

SHUTUP is a system task that permits orderly shut down of an 
RSX-11M/M-PLUS system. It issues warning messages to al] terminals 
connected or logged into the system, aborts all nonprivileged tasks, 
and dismounts all devices. It then halts the system. Run SHUTUP from 
any privileged terminal or from TTO:. 


To successfully shut down a system using SHUTUP, the following tasks 
must be installed: 


1. AT., the MCR indirect command file processor 
2. ACS, only if dynamic checkpoint space has been established 


3. BYE, if multiuser protection support is included 
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4. DMO, if there are any mounted volumes 


5. ERF, if error logging is active 


When activated, SHUTUP identifies itself and then prompts for the 
number of minutes before the system is to be shut down, the interval 
in minutes between message broadcasts, and the number of minutes to 
wait before logins are disabled. For example: 

>RUN SSHUTUP 

RSX11iM SHUT DOWN PROGRAM 

ENTER MINUTES TO WAIT BEFORE SHUTDOWN: 15 


ENTER MINUTES BETWEEN MESSAGES: 3 
ENTER MINUTES TO WAIT BEFORE DISABLING LOGINS: 5 


After receiving this input (the numbers 15, 3, and 5), SHUTUP asks for 
confirmation as follows: 


OK TO SHUTDOWN? CY/NI: 

If the response is negative, SHUTUP terminates. If the response is 
affirmative, SHUTUP broadcasts the following message to all connected 
or logged-in (multiuser protection systems only) terminals: 

PLEASE FINISH UP+ 15 MINUTES BEFORE SHUTDOWN 
Then 3 minutes later, the terminals receive another message: 

PLEASE FINISH UP» 12 MINUTES BEFORE SHUTDOWN 
SHUTUP continues to decrement the first number entered and to issue 
the warning messages at the specified interval until the waiting time 
has elapsed. 
If the system supports multiuser protection, after the specified delay 
before disabling logins has expired (measured from the time SHUTUP is 
started), SHUTUP displays the following message on the invoking 
terminal: 


ALL FURTHER LOGINS ARE DISABLED 


When the delay before system shutdown has expired in an RSX-11M 
system, SHUTUP: 


1. Logs off all logged-in terminals (multiuser systems only) 
2. Stops the console driver (if present in the system) 
3. Redirects the console terminal to the TI: of SHUTUP 


4. I£ the file LB:{1,2]SHUTUP.CMD is present, submits it to AT. 
for execution 


5. Stops the queue manager (QUE...) 


6. Stops the error logging task, if active 
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7. Deallocates all checkpoint space and dismounts 


volumes 


8. Halts the system 


At this point, you can either boot another system 


or 


To continue the current system operation, you must Mount 


and follow normal system startup procedures. 


The following is an example from an RSX-11M system: 


RUN $SHUTUP 

RSXLIM SHUT DOWN PROGRAM 

ENTER MINUTES TO WAIT BEFORE SHUTDOWN: 15 
ENTER MINUTES BETWEEN MESSAGES: 3 

ENTER MINUTES TO WALT BEFORE DISABLING LOGINS: 
QOK TO SHUTDOWN? CY/NI: y 

PLEASE FINISH UP» 15 MINUTES BEFORE SHUTDOWN 
PLEASE FINISH UP+ 12 MINUTES BEFORE SHUTDOWN 
ALL FURTHER LOGINS ARE DISABLED 

PLEASE FINISH UP+ 9 MINUTES BEFORE SHUTDOWN 


PLEASE FINISH UP» & MINUTES BEFORE SHUTDOWN 
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3 


all 


mounted 


resume the 
current system by depressing the Continue switch on the CPU console. 


the 


volumes 
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PLEASE FINISH UP» 3 MINUTES BEFORE SHUTDOWN 
PLEASE FINISH UP+ 2 MINUTES BEFORE SHUTDOWN 
PLEASE FINISH UP» i MINUTES BEFORE SHUTDOWN 
PLEASE FINISH UP+y © MINUTES BEFORE SHUTDOWN 


@LB:fi+2]SHUTUP 


ERF 
ERF -~- REQUESTED “ERRLOG" TO STOP LOGGING 


ERL -- LOGGING ENDED AFTER © ERRORS 


ACS DBO: /BLKS=0, 
ACS -- CHECKPOINT FILE NOW INACTIVE 


DMO DBO:/DEV 


#ee® DBO: -- DISMOUNT COMPLETE 
DMO DBi:/DEY 


##* DBL: ~~ DISMOUNT COMPLETE 


ACS DSO:/BLKS=0, 


ACS -- CHECKPOINT FILE NOW INACTIVE 


DMO DSO:/DEYV 
*##% DSO: -- DISMOUNT COMPLETE 


DMG MMO:;PAYROL 
MTAACP ~- MMO: ** DISMOUNT COMPLETE ** 


To shut down the system in this example, SHUTUP: 


e Invokes the indirect command file [1,2]SHUTUP.CMD, which in 
turn aborts the task ATTT] 


e Runs the task ERF to terminate the error logging task ERL (see 
the RSX-11M/M-PLUS Error Logging Reference Manual) 


e@e Deallocates checkpoint files on DBO: and DSO: (for example, 
ACS DBO:/BLKS=0) 


e Dismounts the disks on DBO:, DBl:, and DSO: (for example, DMO 
DBO:) 


e Dismounts a magnetic tape labeled PAYROL on MMO: (DMO 
MMO: PAYROL) 


SHUTUP also issues Bye commands for all logged-in terminals, except 
the terminal that issued RUN $SHUTUP. Bye then displays a termination 
message like the following: 


HAVE A GOOD AFTERNOON 
24-AUG-78 3:49 TT2@: LOGGED OFF 


Notes: 


e If the time to wait before shutdown is specified as less than 
four minutes, the remaining two questions are not asked; 
minutes between messages is set to 1 and minutes’ before 
disabling logins to 0. 
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Minutes between messages must be non-zero and not greater than 
the minutes before shutdown. Minutes before disabling logins 
must not be greater than minutes before shutdown minus 3. If 


either value is incorrectly specified, SHUTUP rejects the 
answer and re-prompts. 


When 3 minutes’ remain before system shutdown, SHUTUP 


automatically changes the interval between messages to 1 
minute. 


CHAPTER 3 


FILES AND VOLUMES 


This chapter discusses basic concepts of the RSX-11M/M-PLUS file 
system and highlights aspects of file handling which directly relate 
to user functions. In RSX-11M/M-PLUS, a file is an owner-named area 
on a volume, where volumes are magnetic media such as disks, DECtapes, 
and magnetic tapes. 


3.1 FILES-11 


RSX-11M/M-PLUS includes a software system called Files-1l to oversee 
the storage and handling of files. Five MCR functions prepare volumes 
for use with Files-ll: volume Format Utility (FMT), Bad block utility 
(BAD), Initialize Volume (INITVOL), Mount (MOU), and User File 
Directory (UFD). 


Files-1l supports three types of specially formatted volumes: disks, 
DECtapes, and magnetic tapes, (Files-1l magnetic tapes conform to the 
American National Standard Magnetic Tape Labels and File Structure for 
Information Interchange X3.27-1969.) 


Before one of these volumes can be used on RSX-11M, you must properly 
initialize it by issuing the MCR Initialize Volume command (see 
Section 4.5). A volume that has not been initialized by the 
Initialize Volume command is a “foreign” volume. Files-ll, the 
RSX-11M/M-PLUS file system, cannot process foreign volumes. 


A system utility called the File Exchange Program (FLX) allows you’ to 
access foreign (not FILES-11) volumes in DIGITAL's DOS or RT-11 format 
(cassettes, for example). FLX translates files on such volumes’ into 
Files-1ll1 format. In most cases, DECtape will have a foreign format 
and therefore require the use of the FLX utility. See the RSX-11 
Utilities Manual for a full description of FLX. 


Before Files-1l can access a file, the volume that contains the file 
must be known to the system. You make a volume known to the system by 
issuing a Mount command for the device on which the volume is loaded. 


3.1.1 File Ownership and Directories 


When you create a file, the system places the file name in a User File 
Directory (UFD), and stores the user's current User Identification 
Code (UIC) in the file header to indicate the owner of the file. In 
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Most cases, the UFD corresponds to the owner UIC; but a file can be 
listed in a UFD that is not related to the owner’ code. It is also 
possible for a file to be listed simultaneously in more than one UFD. 


A UFD is itself a file, which you must explicitly create by means of 
the MCR UFD command (see Section 4.5). Specify a UFD in the format of 
a UIC: {g,m] where g and m are octal numbers in the range of 1-377 
that represent the user's group and member number respectively. The 
actual name of the UFD is a concatenation of the group and member 
numbers, terminated by .DIR. For example, the name of the directory 
that corresponds to the UIC [203,65] is 203065.DIR. (Note that 


leading zeroes are added to the UFD to make g and m three places 
each. ) 


All UFDs are listed in each volume's Master File Directory (MFD), 
which corresponds to UIC [0,0] and is therefore named 000000.DIR. The 
directories (both the UFDs and the MFD) list the names of files and 
contain pointers to each file's header. The file header contains 
information about the file's owner and the physical location of the 
file segments; the header occupies one or more blocks of the volume's 
index file ({0,0] INDEXF.SYS). 


To delete a UFD, first delete all of the files contained in it 
(thereby freeing the space for future use) by typing: 


PIP? Cosm] *.*#5*/DE 
After you delete all the files, delete the UFD by typing: 
PIP CO;G]g¢g¢ggmmm-DIRG*/DE 


where gggmmm is the concatenation of the group and member number 
components of the appropriate UIC. 


Refer to the RSX-11 Utilities Manual for a detailed description of the 
Peripheral Interchange Program (PIP). 


3.1.2 File Protection 
To access a file, you must know the UFD in which it is listed. This 
knowledge, however, is not sufficient to guarantee access. You must 
also satisfy conditions specified in a protection mask associated with 
the file you wish to access. In an RSX-11M-PLUS system, the volume 
that contains the file must be mounted. 
Every file has a protection mask that describes the types of access 
allowed to each one of four defined user groups. RSX-11M/M-PLUS 
defines four types of access: 

e Read 

e Write 

e Extend 


e Delete 
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The four user groups are defined according to UIC: 


e System - All system tasks, which are those that run under a 
UIC having a group number less than or equal to 10(8) 


e Owner - Tasks that run under the same UIC as the file's owner 


e Group Any task that runs under the same UIC group number 
(the first octal number within the brackets) as the 


file's owner 


e@ World - Any task or user that does not fit in one of the 
above categories 


A file owner assigns access rights by one of the following means: 


e The MCR Initialize Volume (INITVOL) command. This command 
allows you to specify default file protection for all files 
subsequently created on the initialized volume (when formatted 
for use within Files-ll). 


e The MCR User File Directory (UFD) command. This command 
establishes access rights to a UFD file only. A user often 
allows read access to a UFD, but denies access to the files 
listed within it. 


e The Peripheral Interchange Program (PIP). PIP has an option 
that enables the owner to alter access rights to files. See 
the RSX-11]1 Utilities Manual. 


e The MCR Mount = command. This command allows you, while 
mounting a volume, to specify the default file protection to 
be given to files created on the volume. This specification 
overrides that established by means of the Initialize Volume 
command. 


To gain access to a file, a task must satisfy the protection mask of 
both the file to be accessed and the UFD in which the file is listed. 
For example, to write to an existing file, you need at least Read 
access to the UFD and Write access to the file. To create a new file, 
you need both Write and Extend access to the UFD. 


3.2 FILE SPECIFIERS 


MCR uses a Standard format for referring to files in a command line. 
The format is a string consisting of one or more input and/or output 
file specifiers, as follows: 


outfilel,...outfilex=infilel,...infilen 


where outfile is an output file specifier and infile is an input file 
specifier. The dots (...) indicate that you may include any number of 
file specifiers in the string, the number being determined by the 
receiving task. The command string (the string of specifiers plus the 
task call or command) cannot exceed 80 characters, the maximum line 
length. For RSX-11M users, the MCR Initialize Volume and Mount 
commands (see Section 4.5) are exceptions to this rule. RSX-11M-PLUS 
users may extend any command line by appending a hyphen to the end of 
the command line (see Section 4.1). 


Some tasks may not require the outfile portion. When it is omitted, 
you can omit the equal sign (=) in some cases. 
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The individual file specifiers (whether input or output) have the 


following format: 


dev: [g,m)filename.type;version/switchl.../switchn 


where: 


dev: 


{g,m] 


filename 


type 


version 


/switch 


specifies the physical or logical device unit on 
which the volume containing the file is mounted. The 
device unit is expressed as a 2-character alphabetic 
ASCII device name (see Section 2.2) and an optional 
l- or 2-digit octal unit number, followed by a_ colon 
(DKO:, DTl: or LP:, for example). 


stands for the User Identification Code (UIC) that 
specifies the User File Directory (UFD) in which the 
file is listed. g and m are octal numbers from 0 to 
377 that represent the owner's group and member 
number, respectively. The brackets are a mandatory 
part of the UIC syntax. 


specifies the name of the file, an alphanumeric 
string from 1 to 9 characters in length. A period 
always separates the file name from the file type. 


consists of a 3-letter mnemonic that identifies the 
nature of the file's contents (file type can be 
null). The standard RSX-11M/M-PLUS file types are 
listed in Section 3.2.2, For example, .FTN indicates 
that the file contains a FORTRAN source program, and 
~OBJ indicates that the contents are object 
(compiled) code. A semicolon (;) always. separates 
the file type from the version number. 


stands for an octal number from 0 to 77777 that 
differentiates various versions of a file. For 
example, when a file is created, the system assigns 
it a version number of 1. When you open the file for 
editing, the system retains the original file for 
backup and creates a new file. The new file has the 
same file name and type, but the version number is 2. 


The numbers -l and 0 have special significance: -1l 
implies the lowest existing version of a file, and 0 
implies the highest existing version. 


consists of an ASCII switch name (usually two 
characters long) that identifies a switch option. 
You can optionally modify the switch as described 
below. Individual tasks specify relevant switch 
options, which generally modify the task's function 
in some way or provide information that the task 
needs to respond correctly to the command line. 


The switch itself has one of three forms: 


/SW sets the switch action 
/-SW negates the switch action 
or 

/NOSW 


J 
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The number of permissible values and the 
interpretation of a switch depend on the task to 
which the switch is directed (switches are task 
specific). 


The switch name may be modified by any number of 


values; these values may be ASCII strings, octal 
numbers, or decimal numbers. The follewing rules 
apply: 
e Numbers terminated by a decimal point (.) are 
decimal. 
e Numbers preceded by a pound sign (#) are 
octal. 


e Whether the default for a numeric value is 
octal or decimal depends on the task to which 
the switch is directed. 


e You may precede any numeric value by a plus 
(+) or minus (-) sign; plus is the default. 


e A plus or minus sign, if present, must precede 
the pound sign (#) of an explicit octal number 
(for example, -#323). 


3.2.1 User Identification Codes (UICs) 


In an RSX-11M/M-PLUS system that does not support multiuser 
protection, each terminal has, at any one time, one User 
Identification Code (UIC). A terminal's associated UIC is determined 
by the last Set /UIC command issued for the terminal, or is [200,200] 
if the terminal's UIC has not been altered since system generation. 
The system uses the current UIC of the issuing terminal whenever you 
omit the UIC field of a file specifier. The system also checks this 
UIC against the protection mask of any file that you want to access; 
the check determines access rights to the file (see Section 3.1.2). 


In a multiuser protection system, a terminal has two UICs: a 
protection UIC and a default UIC. The system checks the protection 
UIC against a file's protection mask to determine the user's access 
rights to the file. The default UIC determines the UFD to be accessed 
whenever you omit the UIC field in a file specifier. 


How the system sets these two UICs depends on the privilege status of 
the user logged onto the terminal. When a nonprivileged user logs 
onto a terminal, the terminal assumes the user's logon UIC as its 
protection UIC. The logon UIC also becomes the initial default UIC; 
but the nonprivileged user can issue a Set /UIC command to alter the 
default UIC. The protection UIC remains unchanged. When a privileged 
user logs onto a terminal, the terminal also assumes the logon UIC as 
both the protection and the default UIC. However, when a privileged 
user issues a Set /UIC command, the system alters both the default and 
the protection UIC. 


After logging into a multiuser protection system, a nonprivileged user 
cannot alter the terminal's protection UIC; whereas a privileged user 
always alters both UICs when issuing a Set /UIC command. Therefore, a 
nonprivileged user can have a default UIC that differs from the 
protection UIC; but the protection and default UICs of a privileged 
user are always identical. 
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3.2.2 File Specifier Defaults 


You may omit any field in a command line file specifier except the 
file name.~ When you omit one or more fields in a file specifier, the 
system assumes the following defaults: 


Field Default 
dev: The pseudo device unit SY:, usually the device on 
which the system volume is mounted. 
_{g,m] The default UIC (see Section 3.2.1) specified for 
each terminal, either: 
e at system generation (see the RSX-11M or 
RSX-11M-PLUS System Generation and Management 
Guide) 


@ by means of the MCR Set command (see Section 4.5) 


e by means of the MCR Hello command (see Section 
2.3.1.1) 


filename No default.! a specifier must include an explicit 
file name or an asterisk (wildcard) within the file 
name field (see Section 3.2.4). 


type One of the standard 3-letter mnemonics listed in 
Section 3.2.3. The type defaulted to depends on the 
task to which the specifier is directed, and whether 
the specifier refers to an input or an output file. 
For example, the FORTRAN compiler defaults the type 
of an input file to .FTN and the type of an output 
file to .OBJ. 


version For input files, the highest existing version number. 


For output files, the highest existing version number 
plus l. 


Note that you must include the version number when 
using PIP to delete ae file. This requirement 
prevents inadvertent deletion of the highest version 
of a file. See the RSX-11 Utilities Manual. 


/switch Switch defaults are established by individual tasks. 


3.2.3 Standard File Types 


RSX-11M/M-PLUS has a standard set of file types used by all 
DIGITAL~supplied software to reflect actual file contents. Although 
you can assign arbitrary 3-letter file types, it is convenient to use 
the standard types described below. 


: The MCR Boot command is the only exception to this rule. See 
Section 4.6. ‘ 


2 The MCR Boot command and specification of $ in the MCR commands 
Install and Run default to device LB:. See Sections 4.5 and 4.6. 


Type 
BAS 
B2s 
CBL 
CMD 
COR 
DAT 
DIR 
FTN 
Fup 
LST 
MAC 
MAP 
MLB 


OBJ 


ODL 
OLB 
SML 
STB 
sys 
TMP 
TSK 
TXT 


ULB 
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File Contents 
A BASIC language source program 
A BASIC-PLUS-2 source program 
A COBOL language source program 
MCR or task commands (an indirect command file) 
A SLP correction file 
Data (aS opposed to a program) 
directory (for example, a User File Directory) 
FORTRAN language source program 
e a ; 4 plas tr " at 
listing 
MACRO-11 source program 


Task Builder memory allocation map 


> TYP SP PY 


macro library 


An object program (output from the MACRO-11 Assembler 


or a compiler) 

A Task Builder overlay description 
An object module library 

The system macro library 

symbol table 

bootable system image 

temporary file 

task image 


text file 


> Pp TP YP PDP PY 


universal library file 


The defaults used by DIGITAL-supplied software are described in 
manuals that pertain to the individual tasks. 


the 
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3.2.4 The Asterisk Convention (Wildcards) 


The asterisk convention allows you to specify more than one file in a 
single specifier by placing an asterisk (*) or "wildcard" in one or 
more fields of the specifier. The wildcard causes the system to 
ignore, the contents of the wild field and to select all the files that 
satisfy the remaining explicitly described fields. 


An asterisk can be placed in any part of the file specifier except the 
device-unit field, which must be explicitly supplied or defaulted to 
SY: (see Section 3.2.2). The following example, using the Peripheral 
Interchange Program (PIP), illustrates the use of wildcards. The 
command line 


PIP=PROG.MACS1,+PROG.OBJ31»/PROG.TSKS1/DE 


deletes the three individual files specified. Since the three files 
have the same file name and version number, but different types, the 
following command line deletes the same files: 


PIP?PROG.*31/DE 


(The switch /DE instructs PIP to delete the files.) The command also 
deletes any other files (on the default device) named PROG with a 
version number of 1. You should check existing files before using 
wildcards (for example, by issuing the command line PIP> PROG.*;1/LI). 


3.2.5 Examples Of File Name Command Strings 


In the following examples, the three letters followed by > are 
standard prompts for the respective system programs. 


e Assemble the MACRO-11 source file CRGPT.MAC and create the 
object output file CRGPT.OBJ. Both files are on DKO: under 
UIC [200,200]. 


MAC?DKO:CZ00 »200]CRGPT.OBJ=DKO: 0200 ,20010RGPT. MAC 


e Delete the file SBG.OBJ;5. The output file specifier is not 
applicable and therefore is omitted. The input device defaults 
to SY:. 


PIP?0200 +20015BG.0BJ55/DE 


e Task build the object file CRGPT.OBJ. The output will be named 
CRGPT.TSK because TSK is the default file type for the Task 
Builder's output file; the device and UIC are also defaulted. 


TKB:CRGPT=CRGPT.OBJ 
TKBG// 


e Delete all files with the name BOBSDAT, regardless of type or 
version. The system uses default values for the device and 
UIC. 


PIP?:BOBSDAT.#5#/DE 
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MCR COMMANDS 


4.1 INTRODUCTION 


You communicate with an RSX-11M/M-PLUS system from a terminal. The 
Monitor Console Routine (MCR) serves as an interface between the 
terminal and the RSX-11M/M-PLUS systen. 


To issue an MCR command, type a command string in response to a 
default (>) or explicit MCR (MCR>) prompt. A command string consists 
of three components: a command name, any required parameters, and a 
line terminator. 


It is not necessary to type the entire command name when submitting a 
command. MCR requires only the first three letters of a command name 
(the exception is Help, which must be entered in full), followed by 
command parameters. 


For example, you can type the Cancel command as follows: 
>CAN taskname 


where taskname is the command parameter and stands for carriage 
return, the line terminator. As in this example, the 3-letter command 
name often consists of the first three letters of the command title. 
Some commands, however, have 3-letter acronyms as command names. For 
instance, the names for the Assign and User File Directory commands 
are ASN and UFD, respectively. 


Although MCR recognizes only the first three letters of a typed 
command name, you can concatenate any number (up to the maximum buffer 
length of the terminal) of alphanumeric characters to those three 
initial letters. To make the intent of the command clear to someone 
reading a printed copy of command input, you can type: 

>CANCEL taskname 


A space or a tab signals the end of the command name; therefore, no 
Spaces or tabs are allowed within the name itself. For example, 


>OPENREGISTER address 
is permissible, while 
>OPEN REGISTER address 
is not. 
Typically, a parameter is a task name, the name of a file, or a device 


specification. A parameter may be modified by either a switch or a 
keyword (defined in Sections 3.2 and 4.2.1 respectively). 
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Press carriage return or the ALTmode or ESCape key (CBC) to 
terminate a command string. When MCR completes command processing 
following aC), it returns the default prompt. MCR suppresses’ the 
default prompt after processing a command string terminated by Cisc_) 
except when Cec) has special significance as a terminator (with the Run 
and Open Register commands, for example). MCR accepts subsequent 
unsolicited input even though the default prompt does not appear. 


This chapter describes in detail all of the MCR commands. Each 
description includes the full command title, the 3-letter command name 
recognized by MCR, any required parameters, and whether or not the 
parameters need to be modified. 


4.2 THE MCR INTERFACE 


MCR reads or parses the input you type and then responds appropriately 
to the input. To service a request, MCR either loads an MCR overlay 
or activates an independent task. 


By following the procedures outlined below, MCR activates the 
appropriate overlay or task to service each command. 


The first three letters of the command name are the most significant 
part of a command line. MCR uses the name to determine the required 
overlay or task. First, it searches a table containing names of 
commands serviced by MCR itself. If the table contains a matching 
command, MCR loads the corresponding overlay, which proceeds’ to 
process the command line. 


If the table does not contain a match, MCR prefixes three dots (...) 
to the command name and then searches the System Task Directory (STD) 
for a task by that name (that is, ...tsk). MCR returns an error if 
the STD does not contain the specified task. 


In an RSX-11M system, MCR displays a TASK ACTIVE message if ...tsk is 
already active at the terminal. If the STD does contain ...tsk, and 
it is not running at the issuing terminal, MCR in RSX-11M_ responds 
conditionally in one of two ways: 


e If ...tsk is not active, MCR requests the Executive to run the 
task at the issuing terminal. 


e If...tsk is active at another terminal, MCR creates a 
temporary STD entry that points to the already active task's 
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disk image. MCR names the temporary task tskTnn, where nn is 

the unit number of the terminal that issued the command, and 

requests the Executive to run the task. When tskTnn exits, 

the Executive automatically deletes its STD entry. 
aus ca 


4.2.1 Keywords 


Some commands use keywords that generally apply to a command argument. 
A keyword is similar in function to the switches described in Section 
3.2. A keyword consists of a slash (/), followed by an ASCII 
identification, and optionally followed by an equal sign (=) and the 
value of the keyword, as follows: 


/keyword=value 


As an example of using keywords, the Install command requires a file 
name parameter specifying the task to be installed. You can append 
keywords to the file name. One such keyword, /TASK, specifies the 
name under which the task is to be installed. Thus, 


+INS BOB. TSK/TASK=AMBER 


installs the task in the file BOB.TSK with a name of AMBER. 


Enter keywords in any order. They are command-specific and are 
defined with each command. 


4.2.2 Comments 


MCR treats a line of text as a comment if the first character in the 
line is a semicolon (;). In addition, you can use the exclamation 
point (!) to delimit comments in a command. The first exclamation 
point starts the comment and the next exclamation point or end of line 
terminates the comment. MCR ignores all text between the two 
exclamation points. For example: 


si THIS LINE 15 A COMMENT 


sTAL !THIS IS A COMMENT STRING! RMDEMO 


Comments are especially useful to clarify commands in MCR indirect 
command files, which are described in Chapter 5. 


4.2.3 Command References To Active Tasks 


4.2.3.1 Task-Naming Convention - In an RSX-11M multiuser protection 
system, more than one copy of a task can be active simultaneously. 
When you request a task that is already active, MCR automatically 
creates a name for a copy of the requested task: tskTnn where tsk is 
the 3-character task name and Tnn is the unit number of the requesting 
terminal. However, to refer to that task from the requesting 
terminal, you only need specify the 3-character task name (tsk). 


4-3 


MCR COMMANDS 


For example, if you request PIP from TT2:, when PIP is already active 
at another terminal, MCR runs a task called PIPT2. To abort PIPT2 
from TT2:, enter the command 

*ABO PIP 


and MCR aborts the correct version of PIP. However, to abort TT2:'s 
version of PIP from another terminal, a privileged user must type 


ABO PIPT2 


(The user at TT2: can also specify PIPT2, but the full name is not 
necessary in most cases.) 


Note that the naming convention does not apply to tasks requested by 
the MCR Run command. 


or use 
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4.2.3.2 Install-Run-Remove Tasks - Whenever a user activates a task 
by means of the install-run-remove option of the Run command in an 
RSX-11M system, MCR names the task TTnn, where nn is the unit number 
of the terminal that requested the task. You can refer to task TTnn 
in a command issued from terminal TTnn: and can omit the task name 
altogether. 


For example, if you issue the command >RUN S$CALC from TTl:, MCR- runs 
the task contained in a file called CALC.TSK listed in the system 
directory (for example, [1,54] in a mapped system), and names it TTl. 
To abort this task from TTl:, issue the Abort command without 
specifying a parameter; that is, 


FABO (ED 
The command 
‘ABD TT1 
issued either from TTl: or any privileged terminal also aborts’ the 


task originally referred to as S$CALC in a Run command issued from 
terminal TTl:. 
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4.3 COMMAND SUMMARY 


The MCR commands described in this chapter are listed below by 
category. This command summary provides a compact overview of the 
facilities available at a user terminal. Commands available to both 
privileged and nonprivileged users are described in alphabetical order 
in Section 4.5. The commands followed by a P in parentheses are 
available only to privileged users. These are described in 
alphabetical order in Section 4.6. 


Initialization Commands 


ACS (P) Allocate or discontinue the use of a 
checkpoint file on disk. 


ASN Define or delete a logical device assignment. 
List current assignments on user's terminal. 


BOOT (P) Bootstrap a new system into memory and 
transfer control to it. 


DMOUNT Dismount a volume by running down file system 
activity and deleting the Volume Control 
Block (VCB). 


FLAGS Create, display, or eliminate group global 
event flags. 

INITVOLUME Initialize an RSX-11M/M-PLUS Files-11 volume. 

INSTALL (P) Install a task in the system. 

LOAD (P) Read a nonresident device driver into memory. 

MOUNT Create a Volume Control Block (VCB) and 


declare the volume online for access by the 
file system. 


SET Alter or display system-wide or terminal 
characteristics. 

TIME Enter the time and/or date into the system; 
display the time and date on the entering 
terminal. 

UFD Create a User File Directory (UFD) in a 
specific volume's Master File Directory 
(MFD). 

UNLOAD (P) Remove a loadable device driver from memory. 


Informational Commands 


ACT Display on the entering terminal the names of 
active tasks. 


ATL Display on the entering terminal names’ and 
status information for active tasks. 


pacha 
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Informational Commands (Cont.) 


Task 


CLQUEUE (P) 


DEVICES 


LUNS 


PARTITIONS 


TAL 


TASKLIST 


Control Commands 


ABORT 
ALTER (P) 


CANCEL 


FIX (P) 


REASSIGN (P) 


REDIRECT (P) 


REMOVE (P) 


RESUME 


RUN 


STP 


UNFIX (P) 


UNSTOP 


Display information about tasks in the clock 
queue, 


Display on the entering terminal the list of 
peripheral devices recognized by the system. 


Display on the entering terminal the list of 
static LUN assignments for a specific task. 


Display on the entering terminal a list of 
the partition definitions. 


Display on the entering terminal the names 
and status of all tasks in the system. 


Display on the entering terminal the System 
Task List. 


Terminate execution of a running task. 
Alter the priority of a task. 


Cancel time-based initiation requests for a 
task (no effect on current execution). 


Fix a task in memory (task becomes memory 
resident). 


Change LUN assignments. 


Redirect all I/O requests from one _ physical 
device to another. 


Remove a task from the 
of Install.) 


system. (Complement 


Resume execution of a suspended task. 


Schedule a task's activation. The task may 
run immediately, after a time delay, or in 


synchronization with the system clock. 
Periodic rescheduling is optional. 
Halt (stop) a task and remove it from 


competition for memory. 
Makes a memory~resident task non-resident. 


Resume execution of a 
(Complement of Stop.) 


stopped task. 


System Maintenance Commands 


BRK (P) 


BRO 


Pass control to the Executive Debugging Tool 
(XDT). Valid only for systems that have 
generated XDT support. 


Broadcast a message to one or ae eset of 
terminals. ; 
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System Maintenance Commands (Cont. ) 


OPEN (P) Display on the entering terminal the contents 
of a memory location for examination or 
modification. 

SAVE (P) Save the image of memory in the file from 
which the system was booted. 

SSM (P) Insert text into error log reports 


Multiuser Protection Commands 


ALLOCATE Allocate a device to a user (establishes the 


device as the user's private device). 


BYE Log off the system. 

DEALLOCATE Deallocate a private device. 

HELLO Log into the system. 

HELP Display the contents of a Help file. 


4.4 COMMAND DESCRIPTION FORMAT AND SYNTAX 


Syntactic 
chapter o 


l. 


al descriptions of commands and messages described in this 
bserve the following notational conventions: 


Lower case indicates a variable whose actual value is 
determined when the command is entered or the message is 
issued. For example, the value of taskname depends on_ the 
name of the task associated with the command or message. 


Brackets [] enclose optional items. A syntactical element 
enclosed in brackets (for example, [dt]) is optional; it may 
or may not be included in the command. One common exception 
to this rule is the syntax for the specification of a UIC. 
The format for a UIC is [ggg,mmm], where the square brackets 
are required syntactical elements. 


Unless explicitly qualified, all numeric values required in a 
command can be entered as decimal or octal. Decimal values 
are indicated by a trailing period; octal values are 
indicated by the absence of a trailing period. Thus, 
255. 
and 


377 


have the same value. (The value 255. is base 10; the value 
377 is base 8.) 


4-8 
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The following subheadings appear in the detailed command descriptions 
of Sections 4.5 and 4.6. Subheadings that do not apply toa 
particular command are simply omitted from the command description. 


Command Name 

This subheading identifies the command name in capital letters. The 
minimal MCR command acronym is shown on the upper right or left 
Margin. The text following this subheading describes the command's 
function. 

Format 

The command format is given, and all parameters are described. 

Command Related Error Messages 

Error messages specific to the command appear under this subheading. 
The command may also produce the common error messages listed in 


Appendix A. These common error messages are not listed with the 
individual commands presented in this chapter. 
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4.5 NONPRIVILEGED MCR COMMAND DESCRIPTIONS 


ABO 


ABORT 


The Abort command terminates execution of an indicated task. 
Nonprivileged users can only abort a nonprivileged task requested from 
the issuing terminal. A privileged user can abort any task. 


Aborting a task forces an orderly termination of the specified task. 
To effect the termination, the system: 


e Performs I/o rundown. Cancels I/o for all 
non-file-structured devices. Allows I/O for file-structured 
devices to complete and then deaccesses the files. Detaches 


all attached devices. (I/O rundown may take a considerable 
amount of time for tasks connected to a network node.) 


e Requests the Task Termination Notification routine (TKTN) to 
display a message on the aborted task's TI: terminal. The 
display describes the reason for the termination and, if the 
task was built with the /PM Task Builder switch or installed 
with the /PMD=YES keyword, the task's ‘registers at 
termination. However, if the task is checkpointed at the 
time TKTN is called to process the abort, TKTN does not 
display the task's registers. 


e Releases the task's partition if the task is not fixed. 


e If the system supports the Alter Priority directive (a system 
generation option), alters the task's running priority to 
247. A task must be memory-resident to be aborted; this 
change in running priority usually causes a quick return for 
a checkpointed task. 


If the command includes the optional keyword /PMD, it forces’ the 
system to produce a post-mortem dump of the aborted task. The system 
therefore produces the dump whether or not the task was built with the 
7PM Task Builder switch or installed with the /PMD=YES keyword. 
Likewise, /-PMD suppresses a post-mortem dump. 


Format: 
ABO[RT] taskname [/PMD] [/TERM=TTnn: ] 
where: 
taskname - The name of the task to be aborted. 
If you omit the taskname, the command attempts to 


abort task TTnn. 


In an RSX-11M system nn is the octal unit number 
of the issuing terminal (see Section 4.2.3). 
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ABO (Cont.) 


oe ne 
Likewise, if you specify only the first three 
characters, abort defaults the taskname_ to 


tskTnn. See Section 4.2.3. 


/PMD ~ A keyword that requests a post-mortem dump of the 
aborted task 


ee 


Examples: 


“ABORT SCAN 


TASK "SCAN" TERMINATED 
ABORTED YIA DIRECTIVE OR MCR 


PC#O76400 
PS=O00030 
ROZQOO0000 
R1=O004230 
R2Z=O074350 
RG=eO00020 
R4=O00000 
RS=O 76000 
SP=+O76114 
=ABO MAC 


TASK "MACTS" TERMINATED 
ABORTED VIA DIRECTIVE OR MCR 


MCR aborted a task called MACT3, even though the command, 
issued from TT3:, specified the 3-letter task name only (see 
Section 4.2.3.1). In an RSX-11M system, the command >ABO 
MACT3, issued from any privileged terminal, would have the 
same effect. In an RSX-11M-PLUS system, the command >ABO MAC 
/TERM=TT3:, issued from any privileged terminal, would have 
the same effect. 


“ABO 
TASK "TT7" TERMINATED 


ABORTED VIA DIRECTIVE OR MCR 


MCR aborted the task, TT7, from TT7:; the taskname need not 
be specified-to abort task TTn. 


Command Error Messages: 


On receiving an Abort command, MCR requests the Executive to 
abort the task. The Executive subsequently activates the Task 
Termination Notification routine (TKTN). TKTN then produces’ the 
termination display Shown in the above examples. Messages 
following an Abort command can therefore come either from the 
command itself or from TKTN. 
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ABO (Cont.) 


Messages From Abort command: 


ABO -- TASK MARKED FOR ABORT 


A previous request has already been made to abort the 
specified task, but the abort has not yet occurred. 
The task marked for abort is probably not currently 
resident in memory. 

ABO -- TASK NOT ACTIVE 


The specified task is not currently active. 


Messages from Task Termination Notification Routine (TKTN): 
TKTN displays information about task aborts, whether caused by 
the MCR Abort command or some other means. The display has the 
format: 


TASK "“taskname" TERMINATED 
abort cause 


Following the displayed cause for the abort is a list of the 
task's registers at the time of the abort. The possible causes 
of the abort are described below. 

Abort Cause Messages: 
ABORTED BY DIRECTIVE OR MCR 


Either MCR or an Executive directive issued by another’ task 
caused the task to be aborted. 


ABORTED VIA MCR 


MCR aborted the task and requested a post-mortem dump. 


11/40 F.P. EXCEPTION 


The task encountered a floating point exception while 
executing on a PDP-11/40, and no SST routine was specified 
to process the trap. 


AST ABORT. BAD STACK 


An AST could not be effected because the AST parameters 
could not be pushed onto the task's stack. 


CHECKPOINT FAILURE. READ ERROR. 


The task could not be read back into memory after being 
checkpointed. 


IOT EXECUTION 


The task executed an IOT instruction, and no SST routine was 
specified to process the trap. 
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ABO (Cont.) 


LOAD FAILURE, READ ERROR 
The task could not be loaded because of a hardware error. 
MEMORY PROTECT VIOLATION 


The task encountered a memory-protect violation, and no SST 
routine was specified to process the trap. 


NON RSX EMT EXECUTION 


The task executed an EMT instruction with an argument other 
than 377(8) or, in the case of a privileged task switching 
to system state, 376(8) and no SST routine was specified to 
process the trap. 


ODD ADDRESS OR OTHER TRAP FOUR 


The task executed a word instruction with an odd address, or 
it referenced a nonexistent memory location, and no SST 
routine was specified to process the trap. 


PARITY ERROR 


A parity error occurred while the task was executing. The 
task was fixed in memory so that the memory could not be 
reused by another task. 


RESERVED INST EXECUTION 


The task executed an illegal instruction, and no SST routine 
was specified to process the trap. 


SST ABORT. BAD STACK 
An SST could not be effected because the SST parameters 
could not be pushed onto the task's stack, or a stack 
overflow was detected in an unmapped system, as indicated by 
a nonzero value in the header guard word. 

TASK EXIT WITH OUTSTANDING IO 


The task exited with one or more outstanding I/O requests. 
Tasks should terminate all I/O operations before exiting. 
The system does, however, clean up all outstanding I/O. 


T BIT TRAP OR BPT EXECUTION 
The task either set the T bit in the Processor Status Word 
or executed a Breakpoint Trap instruction, and no SST 
routine was specified to process the trap. 


TRAP EXECUTION 


The task executed a Trap instruction, and no SST routine was 
specified to process the trap. 


MCR COMMANDS 


ACT 


ACTIVE 


The Active command displays at the issuing terminal the names of only 
terminal-initiated tasks. In RSX-l11M-PLUS systems, the display 
includes the octal unit numbers of the terminals that initiated each 
task. 


When issued in conjunction with /ALL (ACT /ALL), the names of all 
active tasks are displayed at the entering terminal. 


The Active command can also be issued in conjunction with /TERM (ACT 
/TERM=TTn:) to display on TI: the names of all the active tasks for a 
specific terminal. 


Format: 
ACT[IVE] [/keyword] 
Keywords: 


/ALL 
/TERM=TTn: 


Examples: 
RSX-11M systems 


2ACT 
MCReas 
+e 5S 
sACT /ALL 
+: LDR. 
RMDEMO 
MCRees 

+6 e545 
FLiACP 
eee PIP 
2ACT /TERM=TT7: 
+¢ePIP 


RSX-11M-PLUS systems 
ACT 
MCRees (TTI7=) 
ACTT1i7 (TT17:) 


2ACT /ALL 


oe eL DR (Coo0:) 
RMDEMO (TTG2s) 
MORs 6s (TT17:) 


FiilACP (COO: 
DSOOFI (COO: 
DSOLFI (COO: 
LSTACP (COO: 
DBOSF1 (COO: 


wee ee 
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ACT (Cont.) 


AT.Y6 (VTE) 
OMGs os (COOs) 
HROaae (COO:) 
PIPTAL (TTiOis) 
“ACT /TERMSTT1IO7s 
LBRTAY (TTIO7:) 
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ALL 


ALLOCATE 


The Allocate command establishes a specified device as the user's 
private device. (This command applies only to systems that support 
multiuser protection.) Device allocation prevents other nonprivileged 
users from accessing a device (see Section 2.2). Only the device's 
owner or a privileged user can access or deallocate a private device. 


Mounted devices, public devices, or other users' private devices 
cannot be allocated. 


The system automatically deallocates a user's private devices when the 
user logs off (issues the Bye command) 


Format: 


ALL([OCATE] dd[nn:] [=linn:] 


where: 


dd ~The device mnemonic of the device-unit to be 
allocated. 


nn: - The optional device-unit number to be allocated. If 
the command omits nn:, the system allocates the 
first available logical unit of the dd type device 
and displays the allocated device in the following 
format: 


ALL -- ddnn: NOW ALLOCATED 


linn: - The optional name of a logical device, which the 
system creates and assigns to the allocated physical 
device. (This is a local assignment as created by 
the ASN command. ) 


Examples 
TALL DK: 
Allocates disk DK2:. 
“ALL DK: 


Allocates disk DKO:. 
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-ALL DREXKO: 
ALL -- DKG: NOW ALLOCATED 


ALL (Cont.) 


Allocates the first available logical unit of DK (in this 
case, disk DK3:, since units 0,1, and 2 were allocated 
previously or public) and assigns it the logical name XxX0:. 


Command Error Messages: 


ALL -- 


ALL -- 


ALL -- 


ALL -- 


ALL -- 


DEVICE ALLOCATED TO OTHER USER 


The specified device has already 
another user. 


DEVICE ATTACHED 


been allocated by 


The specified device cannot be allocated because it is 


attached to a running task. 


PSEUDO DEVICE ERROR 


The specified device is a pseudo device. Pseudo 


devices cannot be allocated. 
PUBLIC DEVICE 


The command attempted to allocate 
Public devices cannot be allocated. 


USER LOGGED ON TERMINAL 


a public device. 


The command attempted to allocate a terminal that has 


been logged-in by another user. 
cannot be allocated. 


Logged~in terminals 
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ASN 


ASSIGN 


The Assign command defines, deletes, or displays logical-device 
assignments. Logical-device assignments associate logical names with 
physical devices, pseudo devices, or other logical devices. When a 
user assigns a logical name to a pseudo or logical device, the system 
resolves the assignment to the associated physical device. There are 
three types of logical-device assignment: global, local, and login. 


@ Global assignments apply to all tasks running in the system. 
Only privileged users can issue ASN commands to define or 
delete global assignments. 


e Local assignments apply only to tasks initiated from the 
terminal used to make the assignments. Any terminal can 
define or delete its own set of local assignments. 


e Login assignments occur only in systems that support multiuser 
protection. When a user issues a Hello command to log into 
the system, the system automatically assigns the logical name 
SY: to the user's system device, which is the device that 
contains the user's files. The login assignments apply only 
to tasks initiated from the terminal while the current user is 
logged in. Only a privileged user can define or delete login 
assignments. 


Local assignments have precedence over both login and global 
assignments; and login assignments have precedence over global 
assignments. When a user deassigns a local logical-device name, the 
system defaults to any conflicting login assignments. 


A logical-device name has the same syntax as a real device unit; it 
consists of a 2-character ASCII name (alphabetic) and an optional 1- 
or 2-digit octal unit number, followed by a colon(:). The 2-character 
name can either be equivalent to a standard RSX-11M/M-PLUS device name 
(for example, DK:) or it can be two letters picked at random (for 
example, ZY:). 


When a user installs a task or the system processes an Assign LUN 
directive, the system scans the logical device table before the 
physical device table when searching for a specified device. As a 
result, a user can define logical device names that are identical to 
physical device names even though the logical and physical device 
names do not refer to the same physical device. The system resolves a 
specified device name to the first matching table entry found. 
Therefore, if a logical device name is identical to a physical device 
name, the logical name has precedence. 


Nonprivileged formats: 
ASN ppnn:=linn: 


Assign the logical name llnn: to device ppnn:. The command 
establishes a local assignment for the issuing terminal. 


ASN 


Display at the issuing terminal all local and login 
logical-device assignments. 
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ASN =[(llnn:] 
< 
Delete the local assignment of the specified logical-device 
name; or delete all local logical-device assignments for 
the issuing terminal if the command omits llnn:. 
Privileged formats: 
ASN ppnn:=linn: /GBL 


Define a global assignment that associates the logical name 
linn: with device ppnn:. 


ASN /GBL 


Display all global, local, and login assignments for all 
terminals in the system, 


ASN =f{llnn:]/GBL 


Delete the specified global logical-device assignment; or 
delete all global assignments if the command omits llnn:. 


ASN ppnn:=llnn: /LOGIN[/TERM=ttnn: ] 
Establish a login logical-device assignment for a specified 
terminal, or for the issuing terminal if the command omits 
/7TERM=ttnn:. ; 

ASN /TERM=ttnn: 


Display at the entering terminal all local and login 
logical-device assignments for the specified terminal. 


ASN =llnn: /LOGIN{/TERM=ttnn:] 
Delete the login logical-device assignment indicated by the 
name linn: for a specified terminal, or for the issuing 
terminal if the command omits /TERM=ttnn:. 

ASN =/LOGIN[/TERM=ttnn:;] 
Delete all login logical-device assignments for the 
specified terminal, or for the issuing terminal if the 
command omits /TERM=ttnn:. 

ASN =[llinn:]/TERM=ttnn;: 
Delete the local logical-device assignment indicated by the 
name linn: for the specified terminal; or delete all local 
logical-device assignments for the specified terminal if the 
command omits llnn:. 

where: 
pp - Physical, logical, or pseudo device name 
nn - Unit number 
11 - Logical device name 


tt - Terminal device name 
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Example: 


>ASN 
+ASN 
>ASN 
>ASN 
US2:; 
USI: 
OY: 

+ ASN 
uS2: 
USI: 
SY: 

GBO: 
+ASN 
+ASN 
> ASN 
+ASN 
> ASN 
sASN 


DP:=US1: 
DT:=US2: 
DK: =GBO:/GBL 


DTO: LOCAL 
DPO: LOCAL 
DPQ: LOGIN 
/GBL 

DTO: LOCAL 
DPO: LOCAL 
DPO: LOGIN 


DKO: GLOBAL 


2US2: 
=/GBL 
=USI1: 
DK S=KY¥s 
KYrsZi: 


DRO: LOCAL 
DKOs LOCAL 


Command Error Messages: 


ASN 


ASN 


The /TERM keyword value in an ASN 
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'Define USi: 

[Define USZ: 

iDefine global logical device name GBOs: 
'List local and login assignments 


TI - TT: 
TI - Tia: 
TI - TTQs 
List all assignments 
TI - TTO: 
TI - Tro: 
TI - TTO: 


'Eliminate local logical device name USE: 
'Eliminate all global assigtiments 
'Eliminate local logical device name USi: 
Assign KY: to DK: 

'Assign 22: to KY¥: 

'Display assignments 

TI-TTO: 

TI-TTQ: 


-- DEVICE NOT TERMINAL 


specify a terminal. 


- LOGICAL DEVICE NOT IN SYSTEM 


command did 


not 


The specified logical device name was not included in 


the system at 
not be found in the logical 


device assignment 


for the terminal. 


system generation and therefore could 


table 
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ATL 


ACTIVE TASK LIST 


This command displays on the entering terminal the name and status of 
all active tasks in the system or the status of a particular task 
(task name). The display provides information useful for determining 
the exact status of each active task. The display contains the 
following information for each task: 


e Task name 

e Task control block physical address (octal) 

° Partition name 

e Partition control block physical address (octal) 

e Partition base and limit physical addresses (octal) 

e Task's running priority and default priority 

e Task status flags 

e TI: terminal physical device-unit 

e I/O count, (decimal) 

e Task local event flags 

e Task registers and Processor Status Word (memory-resident 
tasks only) 

e RSX-11M-PLUS also displays the name of the parent task (if 


one exists) as well as the task blocking count. 


The displayed task status flags are from the Task Control Block (TCB). 
This command displays the name of the bit if the bit is set to one at 
the time of the display. Zero bits are not displayed. Flag names are 
three characters long and correspond to the last three characters of 
the mnemonic defining the status bits. (See the RSX-11M or 
RSX-11M-PLUS System Generation and Management Guide for a description 
of the TCB.) For example, FXD represents the bit T2.FXD and indicates 
that the task is fixed in memory. Names prefixed by a minus (-) sign 
indicate that the bit represents the complement of the condition. For 
example, -CHK indicates that the task is not checkpointable. 


If the task is not in memory (the OUT flag is displayed), the contents 
of the PC, the PS, and the registers are not displayed. 


Status TCB Flag Description 
ABO T2.ABO Task is being aborted. 
ACP T3.ACP Task is an Ancillary Control Processor. 
AST T2.AST Task is processing an AST. 
CAL T3.CAL Checkpoint space is allocated in task image. 
-CHK TS.CHK Task is not checkpointable. 
CIP TS.CIP Task is blocked for checkpoint in progress. 
CKP TS.CKP Task is checkpointed. 
CKR TS.CKR Task checkpoint request pending. 
CLI T3.CLI Task is a command line interpreter. 
DST T2.DST Task ASTs are disabled. 
~EXE TS.EXE Task is not in execution. 
FXD T2.FXD Task is fixed in memory. 
HLT T2.HLT Task is being terminated. 
MCR T3.MCR Task was activated by MCR, 
MSG TS.MSG Task aborted, waiting for TKTN message. 


(continued on next page) 
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Status TCB Flag Description 

NET T3.NET Network protocol level. 

NSD T3.NSD Task cannot receive data (no send data allowed). 

-PMD T3.PMD Suppress task Post-Mortem Dump on SST abort 

OUT TS .OUT Task is out of memory. 

PRV T3.PRV Task is privileged. 

RDN TS ..RDN Task I/O is being run down. 

REM T3.REM Task is to be removed on exit. 

ROV T3.ROV Task has resident overlays (RSX-11M-PLUS systems). 

RST T3.RST Task is restricted. 

RUN TS.RUN Task is executing on another processor 
(RSX-11M-PLUS multiprocessing systems. only). 

SEF T2.SEF Task is stopped for an event flag(s). 

SLV T3.SLV Task is slave. 

SPN T2.SPN Task is being suspended. 

SPNA Task was suspended prior to AST. 

STP TS.STP Task stopped. 

STPA Task stopped prior to AST. 

TIO T2.TIO Task is waiting for terminal input. 

WFR T2.WFR Task is in a "wait-for" state. 

WFRA Task was in a “wait-for" state before AST. 

Format: 


ATL [taskname] 
Examples: 
RSX-11M systems 
PATL 


«eel DR O89626 LDR O53572 0O0000000-00000000 PRI - 2468, DPRI -~ 248, 
STATUS:  -CHK FXD STP PRY 


TI -~ COO: Toc - o, EFLG ~ 000001 OOQOO00 PS - 170000 PC ~ Od2516 
REGS 0O-G GOO162 005600 177777 105312 064240 105260 O335d0 
RMDEMOQ OSd4222 GEN O3GGO0 OO204000-00217600 PRI - 225. DPRI - 225. 


STATUS: WFR PRY CAL 
TI - TTO: IOC - 0. EFLG - 900001 Q00000 PS - 170010 PC ~ Lesoa7e 
REGS 9O-G 123354 000061 O00000 125032 O01G601 131530 LE0352 

MCR... 105530 SYSPAR 107734 00110000-00120000 PRI - 169. DPRI ~ 160, 
STATUS: STP -PMD PRY NSD CAL 
TI - TT20: TOC - 0. EFLG ~ 000001 O40000 PS - 170000 PO ~ TEBE 76 
REGS 0-6 00000 120470 121766 120424 122914 900000 120362 

+6+S¥S 105260 GEN OG6d240 


(operator typed to suppress further output) 


“ATL RMDEMO 

RMDEMO OS54222 GEN OSB600 OOZ2Z0d000-00217600 PRI - 225. DPRI - 228, 
STATUS: WFR PRY CAL 
TE - TTO: IOC - 9, EFLG - GO0001 900000 PS - 17090tQ PC -~ Lesove 
REGS 0-6 129354 000061 000000 125032 001601 1391530 120352 
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od 
RSX-11M-PLUS systems 
s ATL 
ree LDR 116340 LORPAR 116124 G04d0G000-00410400 PRI - 248. DPRI - 248, 
STATUS: STP ~PMD PRY FXD 
Tl -~ COO: [0C -O, EFLG - 900001 GOO000 PS - 170000 PC - 120444 
REGS 0-G OO0162 02068685 177777 087300 OG7250 O64110 1270166 
RMDEMO O44724 GEN 043064 O1628700-01641700 PRI ~ 225. DPRI - 225, 
STATUS s WFR -~PMD PRY MCR CAL 
TIo- TTO: IQC - ©, EFLG - G00001 GO0000 PS - 170010 Po -~ 125100 
REGS 0-8 123353 GO00B82 NOO110 125040 OO1601 131774 120352 
MCR+++ 115210 SYSPAR O36B40 OO164000-00174000 PRI - iGO. DPRI - iBo, 
STATUS: STP -PMD PRY CLI NSD CAL 
TI ~ TTOs IOC - GO. EFLG - GO0001 G40000 PS - 170000 Po - Le4aiog 
REGS O-G 600000 120474 O00400 170430 o00115 120510 120360 
DCL.e. O56370 SYSPAR O43560 O0164000-00174000 PRI - iGo. DPRI - 160, 
sa STATUS: STP -PMD PRY CLI NSD CAL OUT CKP BLK: 1 
TI ~ TTi0: I0C - G, EFLG - 000001 odondn 
DEVTGS O620d0 GEN OG2Z314 O1641700-01667500 PRI - 160, OPRI - iGo. 
(operator typed to suppress further output) 
2ATL RMDEMOQ 
RMDEMO 044724 GEN O43064 O1625700-O01641700 PRI - 225, DPRI - 225, 
STATUS: TIO STP -PMD PRY MCR CAL 
TI - TTO: TOC - 0, EFLG - O00000 oo0000 PS - i7o010 PC - 1303952 
REGS 0-6 GOOO5O 000040 000110 128040 001601 131774 120350 
ow’ 
“ a 
wo’ 
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BROADCAST 


The Broadcast command displays a specified message at one or more 
terminals, as follows: 


e A privileged user can display a message at all terminals 
connected to the system, or, in a multiuser protection system, 
at all logged-in terminals. 


@ Both privileged and nonprivileged users can display a message 
at any one terminal. 


You can also create an indirect command file to contain one or more 


lines of input to the command. Each line specifies the target 
terminal and the message to be broadcast. (Privileged users can 
broadcast a message simultaneously to all terminals.) To use the 
command file, enter after the command name the _ file specification 
preceded by an at sign (@). 


If the message cannot be broadcast within 10 seconds, the system 
displays the following message at the issuing terminal: 


BRO -- TERMINAL IS BUSY -- ttn: 


If a privileged user specifies multiple terminals (ALL: or LOG:), the 
system returns one error message for each busy terminal. 


Formats: 
BRO[ADCAST] ttn:message 
BRO[ADCAST] @filespec 
BRO[ADCAST] ALL:message (Privileged format) 


BRO[ADCAST] LOG:message (Privileged format) 


NOTE 


Each format can be entered on two 
successive lines by pressing 
immediately after the command name; 
this invokes the direct task format. 
For example: 


>BRO[ADCAST] 
BRO> ttn:message 


To exit the direct task format type 


; 

where: 
ttn: - Terminal to receive broadcast message. 
message - Message to be broadcast, an ASCII character 


string that cannot exceed the length of one 
line (80 characters). 


MCR COMMANDS 
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filespec - Specification of a file containing one or 
More message lines in the format: 


ttn: message 

or, for privileged users: 
ALL:message or 
LOG: message 


ALL: - Privileged option. Indicates that specified 
message is to be sent to all terminals 
connected to the system (this does not 
include slaved terminals, such as the RMDEMO 
terminal or virtual terminals). 


LOG: - Privileged option. Indicates that the 
specified message is to be sent to all 
logged-in terminals (this does not include 
slaved terminals or virtual terminals). Ina 
system that does not support multiuser 
protection, LOG: defaults to ALL:. 


The Broadcast command displays the message at the specified terminal 
as follows: 


dd:month:yr FROM: ttnn: To:TTnn: 
message 

Examples: 
“BRO ALLSSYSTEM WILL SHUT DOWN 4PM TO GPM 


>BROQ @ED 
BRO? TT3:PLEASE LOAD DISKI ON DKG: 


*BRO @MESSAGE.CMD 
Note: 


The Broadcast command uses the write-breakthrough feature of the 
terminal driver, a system generation option always generated with 
a multiuser protection system. If the system supports’ the 
feature, the broadcast message, under most circumstances, reaches 
all target terminals. If the system does not support’ the 
write-breakthrough feature, the write defaults to a write virtual 
block; the message cannot break through any type of I/O at the 
terminal. 


MCR COMMANDS 


BRO (Cont.) 


Command Error Messages: 


BRO -- 


BRO -- 


BRO -- 


BRO -- 


BRO -- 


COMMAND INPUT ERROR 
The BROADCAST task did not receive the command line. 
(Usually an indirect file could not be found.) Retry 
command. 

COMMAND SYNTAX 
The command line had an improper format. 

ILLEGAL DEVICE SPECIFIED 
The specified device was not a terminal. 

PRIVILEGED COMMAND 
A nonprivileged user entered a privileged option of 
the command, that is, attempted to broadcast one 
message to all connected or logged-in terminals. 


TERMINAL IS BUSY -- ttn: 


The message could not be displayed within 10 seconds 
at the terminal specified by ttn:. 
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BYE 


The Bye command logs the user off a multiuser protection system. The 
system writes a log off message on CO:, displays a terminating message 
on the initiating terminal, aborts any active nonprivileged tasks 
belonging to the user, dismounts volumes mounted by the user (an 
exception is when a privileged user logs off; mounted public volumes 
remain mounted), and deallocates the user's private devices (if any). 


Format: 
BYE 
Example: 


*BYE 
HAVE A GOOD MORNING 
25-JAN-79 10:04 TTiS:s LOGGED OFF 


Depending on the time of day, the system displays HAVE A GOOD 
MORNING, HAVE A GOOD AFTERNOON, or HAVE A GOOD EVENING. 


oe 


Z 
So 
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CAN 


CANCEL 


The Cancel command cancels time-based initiation requests for a 


task. 


These requests result from a RUNS directive or any of the 
time-synchronized variations of the MCR Run command. 

Only a privileged user may issue a Cancel command for a task not 
initiated from the entering terminal. 

Cancel does not affect execution of a currently active task. Cancel 


removes only the time-based schedule requests still in the queue. 
Format: 
CAN[CEL] taskname 
where taskname is the name of the task. 
Example: 


XCAN XKE 


Cancel all periodic rescheduling and time-based initiation 


requests for task XKE, 
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MCR 


COMMANDS 


MCR COMMANDS 


DEA 


DEALLOCATE 

The Deallocate command releases a private (allocated) device, thereby 
allowing other users to access it. (This command applies only to 
systems that support multiuser protection.) Nonprivileged users can 
deallocate only private devices that they themselves have allocated. 

A privileged user can deallocate any device in the system. 


Note that when an owner of a private device logs off (issues the Bye 
command), the system deallocates all that user's private devices. 


If an allocated device has been mounted, it must be dismounted before 
you deallocate the device. 


Format: 


DEA[LLOCATE] [ddn:] 


where: 
ddn: - The device unit name and number of the private device 
: to be deallocated. If the command does not specify a 
device-unit, the system deallocates all private devices 
owned by the user logged onto the requesting terminal. 
Example: 
*DEALL DKs 


Deallocate disk DK:. The deallocated device can now be mounted 
or allocated by other users. 
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DEV 


DEVICES 


The Devices command displays on the entering terminal the symbolic 
names of all devices or, optionally, all of a particular device type 
known to the system. The device names appear in one’ column; second 
and subsequent columns contain additional information (when necessary) 
about each device. 


Format: 


DEV[ICES] [dd:] 
DEV[ICES] [/LOG] 


where: 
dd: - The device unit name to be displayed. 
/LOG - Displays all logged on terminals. 


Examples: 


RSX-11M systems 


>DEV 

DBOs PUBLIC MOUNTED LOADED TYPE=RPO06 
DBi:s PUBLIC MOUNTED LOADED TYPE=RP0OG 
DBZ: PUBLIC MOUNTED LOADED TYPE=RPO4 
DBS: TTGO: - PRIVATE LOADED TYPE=RPO4 
DB: OFFLINE LOADED TYPE=RPO4 

DKO: TT14s - PRIVATE MOUNTED LOADED 
DKi: TTZ22: - PRIVATE MOUNTED LOADED 
DK2s TTSi: - PRIVATE MOUNTED LOADED 
DKGs TTS2: - PRIVATE MOUNTED LOADED 
DMO: LOADED TYPE=RKOG 

DMi: TTG6O: - PRIVATE LOADED TYPE=RKOG 
DRO: OFFLINE LOADED TYPE=RMO3 

ORI: LOADED TYPE=RMO3 

DSas PUBLIC MOUNTED LOADED TYPE=RS04 
DSi: PUBLIC MOUNTED LOADED TYPE=RSO4 
DTOs LOADED 

DT 1s LOADED 

DTZ: LOADED 

DTS: LOADED 

KOs LOADED 

Kis TT14: - PRIVATE MOUNTED LOADED 
LPOs PUBLIC LOADED 

MMO: TTGOs - PRIVATE LOADED 

MMi: TT19: - PRIVATE LOADED 

TTQs LOADED 

TT1: LOADED 

TTe: [3izZ+i1] - LOGGED ON LOADED 

TTS: LOADED 
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TT4: 
TTS: 
TTG: 
TT7: 


TT10: 
TT1d1s 
TT1la2s 
TT13: 
TT14: 
TTS: 
TT1G: 
TT17: 
TT203 
TT2is 
TT2@e: 
TT23: 
TT24: 
TT2S: 
TT2G: 
TT27: 
TTG0: 
TT31: 
TTB2: 
TT33: 
TT345 
TT35: 
TTGG: 
TT37: 
TTdo: 
TTAl: 
TT42: 
TT43: 
TT44:s 
TT45: 
TT4G: 
TTA7: 
TT3Os 
TTSt1: 
TTS2:3 
TTS3: 
TTS4: 
TTSS5s 
TT3G: 
TTS7: 
TTGOs 


COOs 
NLOs 
TIO: 
CLOs 
L.BOa 
SYOs 


SDE 
TT2s 
TT4s 
TTGs: 
TT7s 
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[302/310] - LOGGED ON LOADED 
LOADED 

[306,14] - LOGGED ON LOADED 
[50,25] - LOGGED ON LOADED 
L306,50] - LOGGED ON LOADED 
LOADED 

(7+367] - LOGGED ON LOADED 
£301+350] - LOGGED ON LOADED 
[7:2] - LOGGED ON LOADED 
LOADED 

LOADED 

C7+3611 - LOGGED GN LOADED 
LOADED 

[304,303] - LOGGED ON LOADED 
[304;4] - LOGGED ON LOADED 
C301;+974] - LOGGED ON LOADED 
LOADED 

LOADED 

[301,350] - LOGGED ON LOADED 
LOADED 

LOADED 

[7+71] - LOGGED ON LOADED 
LOADED 

[306+94] - LOGGED ON LOADED 
£304,307] - LOGGED ON LOADED 
[301,360] - LOGGED ON LOADED 
LOADED 

LOADED 

LOADED 

LOADED 

£304+6] - LOGGED ON LOADED 
LOADED 

LOADED 

LOADED 

LOADED 

[7+337] - LOGGED ON LOADED 
C301;9351] - LOGGED ON LOADED 
[304,151] - LOGGED ON LOADED 
[2+;300] - LOGGED ON LOADED 
[7+373] - LOGGED ON LOADED 
[306,33] - LOGGED ON LOADED 
L70;40] - LOGGED ON LOADED 
[301+350] - LOGGED ON LOADED 
L303+1] ~ LOGGED ON LOADED 
{306+17] - LOGGED ON LOADED 
LOADED 


LPOs 
DBO: 
DBO: 


/LOG 
C3i2s1] 
C302 +910) 
C306+14) 
[S025] 
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DEV (Cont.) 


TT10: (306,50) 
TTiz: (7+3673 
TT13: [391,350] 
TT14: C72] 
TT17: C7+361] 
TT21: C3904+3031 
TT223 C304 ,4] 
TT233 [301,374] 
TT26: C301;3507 
TTS: £7+71] 


TT33: C306 534] 
TT345 C304 +307] 
TT3S: C301 +360] 


TT423 [304,61] 
TTA7: C7+3371 
TTSOs [301,335] 
TTS1: C304,15] 
TTS2: [2,300] 
TT53: C7+3731 
TTS4: C306 +33] 
LT So3 [70+d40) 
TTS6: C301+350] 
TES? [303,11] 


TTGO: C306+17] 


RSX-11M-PLUS systems 


“DEY DB: 


DBO s 


PUBLIC MOUNTED LOADED LABEL=1i1MDEW TYPE=RPOG 


QB 1s PUBLIC MOUNTED LOADED LABEL=LISTING TYPE=RPOG 
DBs TTS7: - PRIVATE MOUNTED LOADED FOREIGN TYPE=RPO4 
DBS s PUBLIC MOUNTED LOADED LABEL=RSX11MPBL4 TYPE=RPOd 
“DEW /LOG 

TTL7s (393+9] (303,31 14-FEB-79 16:30 6 A. ROBERTS 
TT208 C7+24] f€7+24] 14-FEB-79 16:35 6 GG. MATT 
TT23: C7 +30] [7+90] 


14-FEB-79 16:26 2 F,. MICHEALS 


The following notes describe the messages that can appear in the 


subsequent columns. More than one message can appear on the same 
line. 

@ MOUNTED indicates that the device is mounted. If a privileged 
user issues the command, the display includes the mounted 
volume's label. 

@ PUBLIC indicates that the device has been set public. 

e TYPE indicates the device type. 

@ MARKED FOR DISMOUNT indicates that a mountable device has been 


requested to be dismounted, but the dismount operation has not 
yet been completed. 
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DEV (Cont.) 


OFFLINE indicates that, although the system tables contain 
entries for this device, the host configuration does not 
contain the related device, 


{uic] LOGGED ON indicates that the user identified by [uic] 
(the protection UIC) has logged onto the terminal. 


LOADED indicates that a loadable device driver is currently 
loaded. 


UNLOADED indicates that a loadable device driver is currently 
not loaded. 


A device name in the second column is the device to which the 
corresponding device in the first column has been redirected. 


A terminal name in the second column followed by the text 
". PRIVATE" indicates that the device named in the first 
column has been allocated to the user logged on to the 
terminal in the second column. 
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DMO 


DISMOUNT 


The Dismount command requests the file system to mark the volume for 
dismount and release the control blocks. Marking a volume for 
dismount denies additional files access to the volume. After all 
files accessed on the volume are deaccessed, the ACP releases the 
control blocks and thus completes the dismount operation. 


If a single user has mounted a volume, the Dismount command declares 
the volume logically offline. In an RSX-11M-PLUS system, the volume 
cannot be accessed until it is mounted. In an RSX-11M system, since 
there is no Ancillary Control Processor (ACP) associated with the 
unmounted volume, only specific tasks (such as INI, DSC, and BAD) are 
granted private access. If multiple users have mounted a volume, the 
volume remains accessible until all users have dismounted it. 


When the dismount operation completes, either through the Files-ll 
disk system or the ANSI magnetic tape system, the command prints the 
message 

*** dev: DISMOUNT COMPLETE 


on the console terminal (CO:). There may be a considerable delay 
between the issuance of the command and the printing of this message 
if a number of I/O requests are pending and/or a number of files are 
accessed on the volume. When Dismount completes its processing, it 
immediately prints on the issuing terminal the device from which the 
user has dismounted without waiting for I/O run down or file 
deaccessing. 
Nonprivileged users can only dismount volumes that they themselves 
have mounted. A privileged user can dismount any mounted volume. In 
RSX-11M-PLUS systems, you cannot dismount a volume on a shadow device; 
you must first stop shadow recording. 
Format: 
>DMO ddn: [label] [/keyword(s) ] 
or 
>DMO /USER [keywords] 
Keywords: 
/DEV 
/USER 
/TERM=ttnn: 
/LOCK 


where: 


ddn: - Device-unit that holds the volume to be 
dismounted. 


volume-label - The Files-11 volume label may be up to twelve 


characters in length for disk and DECtape, and up 
to six characters for magnetic tape. 


4-36 


It is used to verify that the 


being 

is pe 

Keyword Definitions: 
DEV - /DEV. 


users from 
volume cannot 


Privileged keyword. 
a specific 
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dismounted. 


rformed). 


This 
device. 
be accessed; 


be accessed by an ACP. 


USER - /USER. This 
has mounted, 

TERM -— /TERM=ttnn:. 
all volumes 
mounted. 


keyword dismounts all volumes 


Privileged keyword. 
that a user at 


DMO (Cont.) 


proper volume is 


A volume label is optional (if 
the command omits a label, no volume label 


check 


keyword dismounts all 
In RSX-1l1M-PLUS, the 


in RSX-11M, the volume cannot 


that a user 


This keyword dismounts 
a specified terminal has 


i 
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Examples: 


>DMO 


+ DMO 


»~DMOQ 


DKi: AMBER 


Dismounts disk DK1l:. If a single user has mounted the 
volume, the command dismounts the volume. If more than one 
user has mounted the volume, the volume remains mounted for 
the other users. 


OKis/DEYV 


Places the volume in Drive DkK1L: logically offline and 
releases all control blocks. 


/USER/TERM=TT17:2 


Dismounts all volumes mounted by terminal TT17:. 


Command Error Messages: 


DMO —- CHECKPOINT FILE STILL ACTIVE 


The command attempted to dismount a volume that 
contained an active checkpoint file. The volume 
cannot be dismounted until the checkpoint file has 
been discontinued. Issue an ACS command to 
discontinue the file and reissue the DMO command when 
the system issues a message to indicate that the 
checkpoint file is inactive. 


DMO -- NO VOLUME LIST 


The command specified a magnetic tape drive for which 
a mounted volume label list does not exist. 


DMO -~ SHADOW RECORDING IS ACTIVE ON ddnn: 


In an RSX-11M-PLUS system, the command specified a 
shadow device. Shadow devices cannot be dismounted; 
first stop shadow recording and then reenter the 
command. 


DMO -- VOLUME NOT MOUNTED A\J 


The specified device was not mounted. 
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DMO -- VOLUME NOT MOUNTED BY TI: 


The command specified a dismount operation for a 
volume that was not mounted from the issuing terminal. 


DMO -- WRONG VOLUME LABEL 


The volume label and the label specified in the 
command did not match. 
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GROUP GLOBAL EVENT FLAGS 


The Flags command creates, eliminates, or displays group global event 
flags. Group global event flags provide each UIC group with 32 event 
flags in addition to the 32 common and 32 local event flags. Group 
global event flags are similar in use to the common event flags (see 
the RSX-11M/M-PLUS Executive Reference Manual). However, enly those 
tasks running under the same group UIC can modify group global event 
flags. 


Nonprivileged users can only create or eliminate group global event 
flags for their login group UIC. 


Privileged users can create or eliminate group global event flags for 
any group. 


Format: 


>FLA[GS] [ggg/keyword] 


where: 
ggg - Represents the group for which the group global event 
flags are to be created 
keyword - Specifies whether the group global event flag is to be 
created or eliminated 
Keywords: 
CRE - /CRE. This keyword creates group global event flags 
for the specified UIC group. 
ELIM - /ELIM. This keyword eliminates group global event 


flags for the specified UIC group. 


Lf you omit the group number and keyword specification, the command 
displays all the group global event flags in the form: 


ggg access count event flags [DEL] 
where [DEL] indicates group global event flags marked for delete. 
Examples: 

“FLA 3Q3/CRE 


Creates group global event flags for all tasks running under the UIC 
group number 303. 


FLA 
Displays the access count and event flags set for the UIC 
group 303. 

"FLA 303/ELIM 


Eliminates group global event flags for UIC group 303. 
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HELLO 

The Hello command logs a user onto a terminal to gain access to a 
multiuser protection system. Before a user logs in, the system 
rejects all MCR commands except Hello and Help. Parameters to the 


Hello command are a last name or User Identification Code (UIC) and a 
password; the system validates these parameters according to entries 
in an accounting file. If the password matches the name or UIC 
supplied, the system: 


e Sets the terminal to privileged or nonprivileged status 
according to the user's UIC (a privileged user has a group 
number less than or equal to 10(8)) 


e Assigns the login logical-device name SY0: to the user's 
system disk (the disk that contains the user's files) 


e Establishes the user's login UIC, which is the initial default 
uIc 


e Records the current time and date and other information about 
the terminal session in the system file 


nae ae as 
e Displays a system identification, the current 
time the user logged onto the terminal 


® Optionally displays the contents of the file LB:[1,2]LOGIN.TXT 
(you can suppress part of the display by typing CTRL/O) 


e Submits SY:[login uic]LOGIN.CMD to MCR if it is present 
e Displays the default prompt 
Formats: 


In the following command formats, the braces indicate that the user 
enters one of the two parameters. 


e@ >HEL[LO] uic /password 
username 
e >HEL[LO] RET 
ACCOUNT OR NAME: Nene RET 
username 


PASSWORD: password 


@ >HEL[LO] vase \ RET 
username 
PASSWORD: password 


HEL (Cont.) 


where: 


uic - 


username = 


password - 
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The user's User Identification Code (UIC). The 
command allows the following four UIC 
representations: 

g,m 

[g,m] 

g/m 

[g/m] 
To suppress part of the display of the file 
LB:(1,2]LOGIN.TXT, use the slash form (that is, 
g/m or [g/m]). 
The variables g and m are octal numbers from 1_ to ~ 


377 that represent group and member numbers, 
respectively. 


The user's last name, which can be entered in 
place of a UIC. 


An alphanumeric password. If you type the 
password in response to the prompt PASSWORD:, the 
system does not display the typed characters. 


If the HELLO command was successful, the system displays the following 


message: 
system i.d. 


greeting 
dd-mm-yy hh: mm 


[login-text] 
where: 


i.d. = 


greeting - 


dd-mm-yy - 
hh:mm ~- 


LOGGED ON TERMINAL ttnn: AS XxXxnnnn 


is one of the following, depending on the system: an, 
RSX-11M-PLUS VOl BL6 MULTI-USER SYSTEM 
RSX-11M BL26 MULTI-USER SYSTEM 


One of the following greetings, depending on the 
time of day: 


GOOD MORNING 
GOOD AFTERNOON 
GOOD EVENING 
GOOD NIGHT 


The current date. 


The time the user logged in. 


login-text 
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- The contents of the file LB:[(1,2]LOGIN.TXT. The 


System displays the contents of this file as 
follows. Tf you use _ the slash form when 
specifying the UIC, the display concludes at the 
first percent sign (%) in the file at the initial 
login for that user. Subsequent logins by that 
user (using the slash form) do not display the 
contents unless LOGIN.TXT has been edited. If you 
do not use the slash form, the system displays the 
entire file. (Note that you can type CTRL/O to 
discard all text after the first percent sign in 
LOGIN.TXT.) If this file does not exist, the 
message MESSAGE FILE ERROR ~26 is displayed. 


Examples: 


The following examples are from an RSX-11M system. 


“HEL 
ACCOUNT OR NAME: AMBER 
PASSWORD s 
RSX-11M BL2G MULTI-USER SYSTEM 


GOOD MORNING 
é-FEB-79 10203 LOGGED ON TERMINAL TT2o: 


2-FEB-79 


*** NEW DISK CONFIGURATION *** 
DBO: System and User disk 


(User typed to stop output.) 


SHEL €301/3651] /BOB 

RSA-LIM BL2G MULTI-USER SYSTEM 
GOOD MORNING 
2-FEB-78 10:06 LOGGED ON TERMINAL TT2o0: 
SHEL 901/365 
PASSWORD s 

RSX~LIiM BL2G MULTI-USER SYSTEM 


GOOD MORNING 
3-FEB~79 09°45 LOGGED ON TERMINAL TT17s: 


SHEL 301,365 /BOB 


RSX¥-11iM BL2G MULTI-USER SYSTEM 
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GOOD MORNING 
q-FEB-79 09:45 LOGGED ON TERMINAL TT17: 


2-FEB-79 


¥** NEW DISK CONFIGURATION *** 


(User typed Gru ) 
Command Error Messages: 
HEL -- ACCOUNT FILE OPEN FAILURE 


The account file was open for another user; or the 
disk containing the account file was not mounted. 
Retry the command. 


HEL ~- ACCOUNT FILE RECORD(S) LOCKED 


An RSX-11M-PLUS error message. The resource 
accounting system or the ACNT program could not access 
an account record. Retry the command. 


HEL -- CANNOT ALLOCATE UAB 


An RSX~11M-PLUS error message. The resource 
accounting system requires space in secondary pool to 
allocate a User Account Block (UAB). If sufficient 
space is not available in secondary pool, 
nonprivileged users cannot login. (Resource 
accounting accepts a switch, /POOL RESERVE, that 
permits the system manager to alter the secondary pool 
limit. See the RSX-l11M-PLUS System Generation and 
Management Guide for complete details.) 


HEL -- COMMAND INPUT ERROR 


A system directive or the RUN command, rather than the 
HELLO command, has initiated the HELLO task. 


HEL -- INVALID ACCOUNT 


The name or UIC specified in the command is not stored 
in the account file; or the password specified does 
not match the name or UIC given. 


HEL -- LOGINS ARE DISABLED 


The system was in the process of shutting down; or 
the command SET /NOLOGON has been issued. A user 
cannot log onto a terminal at these times. 
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HEL -- MESSAGE FILE ERROR nnn. 


The system could not open the file LOGIN.TXT for a 
reason indicated by the FCS code nnn. See Appendix I 


of the IAS/RSX-11 I/O Operations Reference Manual for 


a definition of the FCS code. 
HEL -- OTHER USER LOGGED ON 
Another user was currently logged onto the issuing 


terminal. Only one user at a time can be logged onto 
a terminal 


- TERMINAL ALL 


The issuing terminal was allocated to another user. A 
user cannot log onto a terminal allocated to someone 
else. 
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HELP 


HELP 


In an RSX-11M system, the Help command displays the contents of the 
file [1,2]HELP.HLP at the issuing terminal. In an RSX-11M-PLUS 
system, the Help command displays the contents of the file 
[1,2]MCR.HLP or [1,2]DCL.HLP at the issuing terminal. Help is the 
only MCR command that you can issue without logging on. The display 
usually contains information on _ how to log onto the terminal; but 
each installation can change the contents of its Help file to suit 
specific needs. 


Note that you must type all four letters to distinguish Help from the 
Hello command. 


The general format for the Help command is: 


HELP [/CLI] [qualifier] [qualifier2] - qualifier9] 


Another form of the HELP command displays the text contained in the 
HELP file of the user. 


Format: 
HELP % [qualifierl] [qualifier2] [...qualifier9] 


The user must be logged on to request HELP $%. HELP % displays the 
contents of [current UIC] HELP.HLP. 


The form of the HELP.HLP file is: 


1 UPPER-CASE-QUAL 
Text displayed if you type HELP UPPER-CASE-QUAL. 


2 UPPER-CASE-QUAL1 
Text displayed if you type HELP UPPER-CASE-QUAL 
UPPER-CASE-QUAL1. 


2 UPPER-CASE-QUAL2 
Text displayed if you type HELP UPPER-CASE-QUAL 
UP PER-CASE-QUAL2. 


1 ANOTHER-UPPER-CASE-QUAL 
Text displayed if you type HELP ANOTHER-UPPER-CASE-QUAL. 


The numerals are level numbers and range from one through nine 
inclusive. Level numbers must be the first character of their line 
and the qualifiers that follow must be upper case. Arbitrary strings 
of blanks or tabs are allowed between level numbers and qualifiers. 
If a qualifier begins with a dollar sign ($) or a slash (/), the $ of 
/ is ignored. 
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HELP interprets its command line in a strictly nested fashion. When 
interpreting parameters (qualifiers), Help searches the HELP file for 
a line containing a level number one followed by the specified 
qualifier. If such a line exists, Help displays the subsequent text 
until it reaches another level number. If you specify more than one 
qualifier, Help searches for a line containing a level number one 
followed by the first qualifier and then continues the Search for a 
level number two followed by the second qualifier. (Note that the 
search for level number two and the second qualifier stops if Help 
encounters a level number less than two.) If such a line exists, Help 
displays the subsequent text until it encounters another level number. 
The correspondence of qualifier position in the Help command line with 
level numbers in the HELP file continues until the last qualifier is 
found, 


Help permits references within the HELP file to other files that 
contain large blocks of text and/or additional level numbers and their 
qualifiers. Indirect references to other files decreases search time 
and also allows more flexible use of the HELP file. To reference 
another file from within the HELP file, specify an at sign (@) as the 
first non-blank character on a line followed by a file specifier. For 
example: 


@filespec 


where filespec is any legal RSX file Specifier. The default filetype 
is .HLP. However, if you specify a filetype other than HLP, Help uses 
the specified filetype as the default in succeeding indirect 
references, For example, if you specify @filename. .TXT, Help uses 
TXT as the default filetype in future indirect references; the 
default filetype corresponds to the last specified filetype. The file 
version number always defaults to the highest existing version. 


The file referenced in this manner has the same format as the HELP 
file. Note that if the indirect file contains level numbers, the 
level numbers must be greater than the level number in the HELP file 
that precedes the call to the indirect file. For example, if the HELP 
file contains the following lines: 


1 EXAMPLE 
@HELPEXAMPLE 


then HELPEXAMPLE.HLP can only contain level numbers greater than one 
(the numerals 2-9 inclusive). 


Help also allows you to share text between two or more similar or 
Synonomous qualifiers in the HELP file. To do this, specify a pound 
sign (#) followed by the similar qualifier as the first non-blank 
character on a line. For example, to relate the qualifiers LOG and 
HELLO, the HELP file would contain the following lines: 


1 LOG 
#HELLO 
1 HELLO 


See Benn Still for an account and password. 
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Note that the qualifier that contains the displayed text must be of 
the same level number as all the qualifiers that refer to it. Also, 
since Help searches the HELP file sequentially, the qualifier must 
appear after all those that refer to it. 
The following is an example of a HELP file. 

The general form of the HELP command is: 

HELP [qualifieri] [qualifier2] [...qualifier9] 
This displays text from the system help file. 
The other general form of the HELP command is: 


HELP & [qualifierl] [qualifier2] [...qualifier9] 


This displays information from a local (private) help file. This 
syntax is not legal until you are logged in. 


1 LOG 
# HELLO 


1 SPELLING 


Type HELP SPELLING DICTIONARY followed by the word you 
want to spell. 


2 DICTIONARY 


The file DICTIONARY.TXT (which is NOT included in this 
example) contains an abridged listing of frequently 
misspelled words. 

@DICTIONARY 

1 HELLO 


See Benn Still for an account and password. 


1 CREATE 


NOTE 


When creating a HELP file, the first 
line should be blank since it is not 
displayed. 


By convention, each line should begin with a blank or 
tab; the lines cannot begin with the digits 1 through 9 
since these would be interpreted as level numbers. Also, 


depending upon the types of devices in your 
configuration, some practical restrictions should be 
imposed. For example, to accommodate VTO5Bs, lines of 


text should not be more than 72 decimal characters long, 
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and a block of text should not be more than 20 decimal 
lines. If there are level n+l qualifiers (like 2 
UPPER-CASE-QUAL above), they should be mentioned in the 
text so that they are known to exist. Similarly, level 
one qualifiers should be added to the text displayed when 
only HELP is typed. 


If the system contains the above HELP file, the following is the 
display in response to HELP L. (Note that a qualifier may be 
specified by the fewest initial characters that unambiguously define 
it.) 

PHELP L 


See Benn Still for an account and password, 


Command Error Messages: 
HEL == AMBIGUOUS QUALIFIER 


The qualifier does not specify a unique part of the Help file. 
Further information must be supplied. Examine the command line 
that Help displayed below the error message and specify the last 
qualifier displayed more completely. 

HEL -- AMBIGUOUS SYNONYM 


The HELP file attempted to share text between synonomous 
qualifiers, but the qualifier referenced as a synonym was not 
distinct. - 

HEL -- IMPROPER HELP FILE FORMAT 


The Help file is not in proper format and cannot be used. Either 
edit the file or re-enter it in proper format. 


HEL -- INDIRECT FILE OPEN ERROR 


Help attempted to reference another file from within the HELP 
file, but Help could not open the indirect file. 


HEL -- INDIRECT FILE SYNTAX ERROR 


Help encountered a syntax error either in a reference to another 
file or in the indirect file itself. 


HEL -- MESSAGE FILE ERROR nnn 
The Help file could not be opened for the reason specified by the 
FCS code nnn. if the code number is -26, the Help file does not 
exist. 


HEL -- SYNONYM NOT FOUND 


The Help file referenced a synonym, but the file did not include 
it. 
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HEL -- SYNTAX ERROR 
An error in the command format occurred. 
HEL -- UNKNOWN QUALIFIER 


The Help file does not contain the last qualifier printed in 
display of the command line below the error message. 


the 
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The Initialize Volume command produces a Files-11 volume (see Section 
3.1). On disk and DECtape, the command initializes the volume 
(destroys all existing files), writes a dummy bootstrap and a = home 
block, and builds the directory structures. On IMagnetic tape, the 
command writes a volume label according to the ANSI standard and a 
dummy file that destroys all existing files. 
In multiuser protection systems, a user can initialize a volume only 
on allocated, private devices (that is, a device the user has 
allocated). In RSX-11M systems that do not support multiuser 
protection, a user must be privileged to initialize a volume. 
Selecting appropriate values for the command parameters requires an 
in-depth knowledge of Files-1ll. Refer to the IAS/RSX-11 1/0 
Operations Reference Manual for details of the Files-1ll disk and ANSI 
magnetic tape structure. 
Formats: 
INI[TVOLUME] ddn:volume-label [/keyword (s) ] 
Note that you can use a hyphen (-) as the last character on a 
line to extend the INI command line when selected keywords cause 
the command to exceed 80 characters (or whatever buffer size has 
been specified for the entering terminal). You can use any 
number of continuation lines, but the total command line cannot 
exceed 512. characters. 
Keywords: 
/BAD= [option] 
/CHA= [characteristics ]1+ 
/DENS=density selection 
/EXT=block-count 
/FPRO= (system, owner, group,world] 
/INDX=index-file-position 
/INF=initial-index-file-size 
/LRU=directory-preaccess-—count 
/MXF=file-count 
/PRO= [system, owner, group, world] 
/UIC=[group, member]1 
/WIN=retrieval-pointer-count 


/VI 


1 This keyword is included for RSX-11D compatibility. Thus, volumes 
built on RSX-11M can be mounted on an RSX-11D system. 
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(/DENS is the only keyword valid for initializing a magnetic tape 


volume. ) 
wheres 


ddn: 


volume-label 


BAD 


Device-unit name and number of the volume to. be 
initialized. 


The volume label. This may be up to twelve 
characters in length for disk and DECtape, and up 
to six characters in length for magnetic tapes. 
The label identifies the volume and must _ be 
specified. 


/BAD=[option]. The keyword /BAD indicates that 
bad-block processing is to be included in the 
volume initialization. Consequently, bad blocks 
on the volume will be marked as in-use and cannot 
be allocated to files. 


The brackets surrounding each option are required 
syntax. The options are: 


[MAN ] - Accept a bad block list 
specified from the terminal. 


[AUTO] 


Read the bad-block descriptor 
file on the last track of the 
volume created by the 
manufacturer's diagnostic 
routines or the bad block 
locator utility (BAD). 


[NOAU TO] - Ignores the bad-block 
descriptor file and performs no 
bad-block processing. 


[AUTO ,MAN ] 


Read the bad-block file and, 
when done, accept blocks 
specified from the terminal. 


[OVR] - Include the last track in the 
BADBLK .SYS file. This option 
assumes that the bad block file 
is located on the last good 
block before the last track. 
The option is only valid for 
devices that contain 
manufacturer-recorded bad block 
data in the last tracks (DL:, 
DM:, and DR:). 


? 
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[OVR,MAN ] ~ Override the manufacturers’ bad 
block descriptor file and 
accept blocks specified from 
the terminal. 


If the command specifies [MAN], the program 
prompts for bad blocks as follows: 


INI>LBN (S) = 

Bad blocks may then be entered in the format: 
blocknum: number 

where: 
blocknum specifies the bad block number 


number specifies the number of sequential bad 
blocks beginning at blocknum 


INI requires the colon when you specify a sequence 
of bad blocks. Both blocknum and number default 
to decimal unless preceded by a pound sign (#). 


To specify a single block, simply enter the block 
number and omit the colon. 


You can also specify a sequence of bad blocks as 
well as a single bad block on the same command 
line. For example, the command line: 


INI>LBN (S) =100:2,3,200:100,45:1 


enters blocks 100, 101, 3, 200 through 299, and 45 
as bad blocks. You can separate bad block series 
with a space, tab, or comma. 


A null line (a carriage return in response to the 
prompt) displays the bad blocks. The first number 
in the display represents the beginning block of 
the sequence; the second number is the number of 
bad blocks in the sequence. (Note that the 
numbers are decimal. ) 


To terminate bad block input, type Grew orCsc). 


The default is BAD=[AUTO]. INI obtains the bad 
block information from a factory-recorded bad 
block descriptor file, located on the last track 
of an RKO6, RLO1, or RMO3 disk. Note that INI 
also searches the last track for a bad _ block 
descriptor file created by the BAD utility. 
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CHA 


DENS 


EXT 
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- /CHA=[characteristics]. 
are ASCII strings separated by commas. 


The characteristics words 
The square 


brackets are required syntax. For the Initvolume 
command, two characteristics are defined: 

[ATCH] - ATTACH/DETACH (device can be 
used by one task or group 
exclusively); included for 
RSX-11D compatibility. This 
characteristic is not used by 
RSX-11M/M-PLUS. 

Default: no Attach/Detach. 

{DCF] - Device Control Functions are 
permitted; included for 
RSX-11D compatibility. This 
characteristic is not used by 
RSX-11M/M-PLUS. 

Default: ho DCF. 

[ATCH,DCF] - Select both of the above 
options; included for RSX-11D 
compatibility. This 


- /DENS=bit-density. 
density (Bits Per 
loaded on either a 
drive 


characteristic is 
RSX-1L1IM/M-PLUS. 


not used by 


The /DENS keyword sets the bit 
Inch or BPI) of a magnetic tape 
TU16 or TU45 tape drive. The 


must be capable of writing in either single 


density (800 BPI) or double density (1600 BPI). 
Acceptable keyword values are: 
/ DENS=800 
/DENS=1600 
/DENS=HIGH 
/DENS=LOW 
Default: /DENS=800. 
The /DENS keyword also functions to check the 


density of a floppy disk in an RX02 drive, or of a 


tape on a TSO04 drive. 


drive density is 


value for consistency. 


If /DENS is specified, the 
compared against the keyword 
If /DENS is not specified, 


no consistency check is performed and the media is 


initialized at its 


- /EXT=block-count. 


current density. 


The /EXT keyword specifies the 


number of blocks by which a file is to be extended 
when the file has exhausted its allotted space. 


Default: /EXT=5 


FPRO 


INDX 
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- /FPRO=[system, owner,group,world]. The /FPRO 


keyword specifies the default protection for all 
files created on the volume being initialized. 
Access codes consist of four 4-code groups in the 
Access Rights word as follows: 


R = Read 
W = Write 
E = Extend 
D = Delete 


In each instance, the absence of the code means 
that the user is denied the access right. The 
square brackets are required syntax. 


Specify an asterisk (*) in the access rights word 
to force the default value for a specific group. 


Default: /FPRO=[RWED,RWED,RWED,R]. 


NOTE 


Protection code subparameters 
(system, owner, group, world) are 
positional. That is, the location of 
the word in the parameter string 
defines the user to whom the code 
applies. The order is: 


system, owner, group, world 


/INDX=index-file-position. The /INDX keyword 
specifies the index file logical block number. 
This keyword can be used to force the index file, 
the Master File Directory (MFD), and the storage 
allocation file to a specific volume location, 
usually in order to minimize access time. Four 
possibilities are available: 


BEG - Place the index file at the beginning of 
the volume. 

MID - Place the index file at the middle of 
the volume. 

END - Place the index file at the end of the 
volume. 

BLK:nnn - Place the index file at the specified 


block number. 


Default: /INDX=MID (disk devices), /INDX=BEG 
(DECtape, TU58) 
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MXF 


MCR COMMANDS 


- /INF=initial-index-file-size. The /INF keyword 


specifies the number of file headers to allocate 
initially in the index file. The five system 
files INDEXF.SYS, BITMAP .SYS, BADBLK.SYS, 
CORIMG.SYS, and 000000.DIR, are not included in 
the value for /INF. 


Defaults 
DECtape 16 
RKO5 147 
RKO6 834 
RKO7 1654 
RF 16 
RLOI 314 
RLO2 629 
RM0 2/03 4049 
RS03/04 16 
RPO02 1230 
RPO3 2460 
RP04/05 5283 
RPO6 10478 
RX01 16 
RX02 16 


/LRU=FCB-count. The number of directory File 
Control Blocks (FCBs) kept in memory by the ACP 
per volume. These FCBS control access to User 
File Directories (UFDsS). The more FCBS in memory, 
the faster a UFD file can be found. If the file 
is in a directory for which the FCB is resident, 
much of the overhead required to open the 
directory is bypassed. Thus, the time required to 
perform directory operations and open files 
decreases as the number of FCBs increases. 


Default: /LRU=3 


/MXF=file-count. The /MXF keyword specifies the 
Maximum number of files (file headers in the 
volume's index file) permitted on the volume. The 
value for /MXF includes the five system files and 
must be less than or equal to the number specified 
for the device in the table below: 


Theoretical Maximums 


DECtape 278 
RKO5 Disk 2357 
RKO6 Disk 13344 
RF Disk 499 
RLO1 Disk 5034 
RMO3 Disk 25600 
RSO3 Disk 499 
RSO4 Disk 1003 
RPO2 Disk 19680 
RPO3 Disk 25600 
RP04/05 Disk 25600 
w= RPO6 Disk 25600 
RX01 238 
RX02 481 
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Defaults 
DECtape 34 
RKOS5 Disk 294 
RKO6 Disk 1668 
RF Disk 62 
RLO1 Disk 629 
RMO3 Disk 8099 
RSO3 Disk 62 
RSO4 Disk 125 
RPO2 Disk 2460 
RPO3 Disk 4920 
RP04/05 Disk 10567 
- RPO6 Disk 20596 
RXO01 29 
RX02 60 
NOTE 
A Files-11 volume requires five 
files -~- INDEXF.SYS, BITMAP.SYS, 
BADBLK .SYS, CORIMG.SYS, and 
000000.DIR -- to create the on-disk 


structure (See Appendix E of the 
IAS/RSX-11 I/O Operations Reference 
Manual). Thus, MXF value must’ be 
computed by the maximum number of 
user UFD's and files plus the _ five 
files required for the Files-1l 
structure. 


- /PRO=[system, owner,group,world]. The /PRO keyword 


specifies volume access’ rights. Access codes 
consist of four 4-code groups in the access rights 
word, as follows: 


Read 
Write 
Extend 
Delete 


i ou wl 


vum=an 


In each instance, the absence of the code means 
that the user is denied the access right. The 
square brackets are required syntax. 


Specify an asterisk (*) in the access rights word 
to force the default value for a specific group. 


Default: [RWED,RWED,RWED,RWED]. 


1 RSX-11M/M-PLUS does not protect a volume at the UIC level. It does, 
direct access to mounted volumes by nonprivileged 


tasks. This feature permits volume interchangeability with RSX-11D. 
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uIc 


WIN 


VI 


Example: 


SINI 


NOTE 


Protection code subparameters 
(system, owner, group, world) are 
positional. That is, the location 
of the word in the parameter string 
defines the user to whom the _ code 
applies. The order is: 


system, owner, group, world 


- /UIC=[group,member]. Keyword for 


uIc 


parameter specifying the owner of the volume. 


Legal group and member numbers’ range from 


1 to 


377(8). The square brackets are required syntax. 


Default: /UIC=[1,1] 


- /WIN=retrieval-pointer-count. The /WIN 
specifies the number of mapping pointers to be 
allocated for file windows. A file 
consists of a number of mapping pointers; 
stored in memory when the file is opened. 


Appendix F in the IAS/RSX-11 I/0 Operations 
mapping 


Reference Manual for a description of 
pointer.) , 


Default: /WIN=7. 


-~ /VI. The /VI keyword lists all INI keywords and 
their values on the issuing terminal. 
DK1:ICTSVOL2/UIC=C2,+51/1INDX=BEG/FPRO=CRWED +RWE >RW RI] GED 
The Initvolume parameters in the example above are: 
DK1: - Device-unit 
-ICTSVOL2 - Volume-label 
/UIC - User identification code of the volume 
owner; group=2, member=5 
/INDX=BEG ~ Index file location, forced to beginning of 
volume 
/FPRO - Default file protection, specified by group 


as: 


system: Read,Write,Extend,Delete 
owner: Read,Write,Extend 

group: Read,Write 

world: Read-only 


keyword 
window 
it is 
(See 
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Command Error Messages: 


INI 


INI - 


INI - 


INI - 


INI - 


INI - 


INI 


INI 


INI 


INI 


INI 


ALLOCATION FOR SYS FILE EXCEEDS VOLUME LIMIT 
The system was unable to allocate a system file from 
the specified block because of intermediate bad blocks 
or end of volume. 

BAD BLOCK FILE CORRUPT - DATA IGNORED 
Although automatic bad block recognition was selected, 
the bad block data on the disk was not in the correct 
format, and was therefore ignored. 

BAD BLOCK FILE FULL 
The disk had more than 102 bad regions on it. 

BAD BLOCK HEADER I/O ERROR 


An error was detected in writing out the bad-block 
file header. 


BLOCK (S) EXCEED VOLUME LIMIT 


The specified block (or blocks) exceeded the physical 
size of the volume. 


BOOT BLOCK WRITE ERROR 


An error was detected in writing out the volume boot 
block. 


CHECKPOINT FILE HEADER I/O ERROR 


An error was detected in writing out the checkpoint 
file header. 


COMMAND I/O ERROR 


This message indicates that INI encountered an I/O 
error while reading the command line. 


COMMAND TOO LONG 


The command, including continuation lines, exceeded 
the maximum length of 512. characters. 


DATA ERROR 


The command specified a bad=block number or contiguous 
region that was too large. 


DEVICE NOT ALLOCATED TO THIS TERMINAL - ddnn 


The command line specified a private device that was 
allocated to other than the issuing terminal. 
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INT 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


DEVICE NOT IN SYSTEM - ddnn 


The command line specified a device not in the current 
system configuration, 


DEVICE NOT READY - ddnn 


The command specified a volume that was not ready (not 
up to speed). 


DEVICE WRITE LOCKED - ddnn 
The command specified a volume that was write-locked 
and therefore could not be initialized as a Files-1l 
device, 

DISK IS ALIGNMENT CARTRIDGE 
The last track on an RKO6, RLO1l, or RMO3 identified 
the volume as an alignment cartridge, which cannot be 
initialized as a Files-ll volume. An alignment 
cartridge is specifically formatted for aligning disk 
read/write heads. 

DRIVER NOT LOADED 


The command line specified a device for which the 
driver has not been loaded. © 


DUPLICATE BLOCK(S) FOUND 


A block that had already been defined as bad was being 
defined as bad a second time. 


FAILED TO ATTACH DEVICE - ddnn 
INI could not attach the specified device. 

FAILED TO READ BAD BLOCK FILE 
The command was unable to read _ the bad block 
information from the last track of an RKO6, RLOl, or 
RMO3 disk. 

FAILED TO READ MANUFACTURER'S BAD SECTOR FILE 
A disk read hardware error occurred while attempting 
to read the factory-recorded bad block data ona 
last-track device. Reenter the command and include 
the OVR option. 

FAILED TO READ SOFTWARE BAD SECTOR FILE 


The software-detected bad sector file could not be 
read. Reenter the command and include the OVR option. 
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HOME BLOCK ALLOCATE WRITE ERROR 


In overwriting a bad-home-block area, a write error 
occurred, 


HOME BLOCK I/O ERROR 


An error was detected in writing out the volume home 
block. 


ILLEGAL KEYWORD VALUE 

A value entered for a keyword exceeded its limits. 
ILLEGAL UIC 

The command line specified an illegal UIC. 
INDEX FILE BIT MAP I/O ERROR 


An error was detected in writing out the index-file 
bit map. 


INDEX FILE I/O ERROR 


An error was detected in writing out the index-file 
header. 


I/O ERROR SIZING DEVICE - ddnn 


The system encountered an I/O error while sizing an 
RF11l disk. , 


MAGTAPE LABEL MUST BE SPECIFIED 


The command attempted to initialize a magnetic tape 
without specifying the required volume label. 


MAGTAPE DEVICE ERROR ~— ddnn 


While positioning the magnetic tape, the system 
encountered an I/O error. 


MAGTAPE WRITE ERROR - ddnn 


While writing to the magnetic tape, the system 
encountered an I/O error. 


MANUFACTURER'S BAD SECTOR FILE CORRUPT 
The factory-recorded bad block data on a last track 
device is in an inconsistent format. Reenter the 
command and include the OVR option. 

MFD FILE HEADER I/O ERROR 


An error was detected in writing out the Master File 
Directory (MFD) file header. 
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INI 


INT 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


MFD WRITE ERROR 


An error was detected in writing out a block in the 
Master File Directory (MFD). 


NO BAD BLOCK DATA FOUND 
Although automatic bad-block specification was 
selected, no bad-block file was found on the volume. 
This is only a warning; INI continues and initializes 
the volume. 

NOT FILE STRUCTURED DEVICE 


The system does not support Files-1ll on the specified 
device. 


NULL FILE HEADER I/O ERROR 


An error was detected in writing out null-file headers 
to the index file. 


PUBLIC DEVICE - ddnn 


The command line specified a public device. Only 
private devices can be initialized. 


STORAGE BITMAP FILE I/O ERROR 


An error was detected in writing out the storage 
allocation file header. 


UNDEFINED DENSITY SELECTION 
The command specified an illegal density value. 
UNIT DOES NOT SUPPORT 800 BPI 


The command specified a drive that does not support 
800 BPI. , 


UNIT DOES NOT SUPPORT 1600 BPI 


The command specified a tape drive that does not 
support 1600 BPI. 


UNIT DOES NOT SUPPORT HIGH/LOW DENSITY SELECTION 


The command specified a device for which the High and 
Low keywords are undefined. 


INI 


INI 


INI 


INI 


INT 
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UNIT DOES NOT SUPPORT DENSITY SWITCH 


The command specified a device which does not have 
multiple density capability. 


UNIT IS NOT AT LOW DENSITY 


The command line specified that a floppy disk in an 
RX02 drive be initialized at low density, but the 
floppy was formatted at high density. 


UNIT IS NOT AT HIGH DENSITY 


The command line specified that a floppy disk in an 
RX02 drive be initialized at high density, but the 
floppy was formatted at low density. 


VOLUME MOUNTED FILES-11 


An attempt was made to initialize a mounted Files-ll 
volume. Mounted Files-1l volumes cannot be 
initialized. 


VOLUME MOUNTED FOREIGN WITH ACP 


The command line specified a device that was mounted 
foreign, but with an ACP. To initialize a volume in 
RSX-11M-PLUS, you cannot include an ACP name when the 
volume is mounted as foreign. 


VOLUME NAME TOO LONG —- (volume name) 


The command line specified a volume label that 
exceeded six characters for magnetic tape devices or 
twelve characters for disk devices. 


WARNING BLOCK 0 IS BAD 


Block 0 of the specified volume, the boot block, was 
bad. Therefore, a bootable image cannot be placed on 
this volume. This is only a warning; INI continues 
and initializes the volume. 
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LOGICAL UNIT NUMBERS 


The LUN command displays at the entering terminal the static LUN 
assignments for a specified task. (Static assignments are those 
recorded in the task's disk-image file.) The display consists of a 
list of physical device units in one column, with the corresponding 
LUNS in an adjoining column. 


When the specified task is running, the display does not necessarily 
reflect the running task's assignments. For example, an Executive 
directive issued from within the task (Assign LUN) can alter the LUN 
assignments. 


If the specified task was initiated by the install, run, and remove on 
exit option of the MCR Run command the task has no static LUN 
assignments. In this case, the message 


LUN -- TASK NOT IN SYSTEM 
is displayed. 
Format: 

LUN[S] taskname 
Example: 


*LUN XKE 
CLO: 3 
TT3: 4 
TT3: 5 
DKO: 6G 
TT3: 7 


The display shows static assignments for LUNs 
3, 4, 5, 6, and 7, recorded in the task-image file header; 
no other LUNS are statically assigned to the task XKE. 


Command Error Message: 
LUN ~- NO LUNS 


The task that is the argument of the LUNs command did 
not have any logical units. This is not precisely an 
error message, but rather an indication that there 
were no assignments to display. 


LUN ~~ TASK NOT IN SYSTEM 


The specified task is not installed; or, the task was 
initiated by the install, run, and remove on exit 
option of the MCR Run command. This is not precisely 
an error message, but rather an indication that there 
were no assignments to display. 
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MOUNT 


The Mount command permits file system software access to physical 
devices. For all volumes on these devices, Mount creates the file 
system control blocks that the Ancillary Control Processors (ACPs) use 
to support data access on the device. Mount also declares, provided 
an online access path exists, that the volume is logically online for 
access. 


The command then requests the ACP to mount the volume set. Mount 
defaults the ACP name to ddnnFl for disks and DECtapes. This permits 
you to tailor the ACP that controls a specific volume and then name 
that ACP after the volume. For example, if you tailor FI11ACP for an 
RKOS disk and install it as DKO1F1, then when you issue a Mount 
command for DKl:, Mount searches for the ACP DKOIF1l. If an ACP does 
not exist by this name, it defaults to F1llACP for disks. The default 
ACP for DECtapes is DTAACP and then F1l1lACP if DTAACP does not exist. 
The default ACP for magnetic tapes is always MTAACP. 


RSX-11M systems permit specific tasks, such as INI and DSC, access’ to 
unmounted volumes. It is only necessary to Mount a magnetic tape if 
it is an ANSI standard tape. FCS treats unmounted magnetic tapes as 
unit record devices. 


When a device is dismounted, outstanding I/O is allowed to complete, 
but no additional files can be accessed on that volume (see the 
description of the Dismount command). To ensure that a mounted volume 
remains accessible, each user of the device should issue a Mount 
command. Thus, each user that mounts a volume declares the volume 
logically online, regardless of subsequent Dismount commands issued by 
other users. 


A nonprivileged user can mount a volume on: 


e The user's private device (that is, a device that the user has 
allocated). No other nonprivileged user can access or mount 
the volume until the volume is dismounted and deallocated. 


e A mounted public device. All system users can access’ the 
device. To insure that the device remains accessible, each 
user of the device should issue a Mount command. Note that a 
privileged user must first mount a public device before 
nonprivileged users can issue subsequent Mount commands. 


® Any other device that has not been allocated or set public. 
If another user mounts the volume, that user can also access 
it. 
A privileged user can mount a volume on any random access device. 


Only a single user can mount magnetic tape volumes. 
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To mount DECtapes as Files-1ll volumes, the command defaults the ACP to 
DTAACP, or to FLI1ACP if DTAACP is not present in the system. (Note 
that the keyword /ACP always overrides the default.) The use of DTAACP 
has the advantage that it avoids tying up the disk ACP (F11ACP) during 
the relatively long searches inherent in DECtape processing. 
If powerfail recovery support was selected during system generation, 
there is a delay when Mount is specified for a volume that is 
off-line. 
The description of the Mount command format consists of two parts 
which separately illustrate the parameters and keywords associated 
with Files-1l volumes other than magnetic tape and Files-1l ANSI 
Magnetic tapes respectively. All the keywords are collectively 
described following the format descriptions. 
Files-1l Disk or DECtape Format: 
MOU[NT] ddn: [volume-label] [keyword (s) ] 
Note that since the override volume label keyword (/OVR) is a 
privileged option of the Mount command, in a multiuser protection 
system, a nonprivileged user must always specify the volume-label. 
You can use a hyphen (-) as a line terminator to extend the Mount 
command line when selected keywords cause the command to exceed 80 
characters (or whatever buffer size has been specified for the 
entering terminal). You can use any number of continuation lines, but 
the total command line cannot exceed 512(10) characters. 
Keywords: 

/ACP=taskname 

/DENS=density 

/EXT=block-count 


/FOR 

/FPRO=[system, owner, group,world] 

/LRU=FCB-count 

/OVR 

/PARM="user parameters" 

/UIC=[uic] 

/UNL 

/VI 

/WIN=retrieval-pointer-count 

Mount keywords for Files-11 devices override corresponding 


values in the volume's home block. (Mount also passes 
keyword values to foreign ACPs. ) 
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where: 
ddn: - Device-unit on which the volume is to be 
mounted, 
Default: none; must be specified 
volume-label - The Files-11 volume label may be up to 12 


characters in length. It is used to ensure that 
the correct volume is being mounted. In a 
multiuser protection system, the command must 
include a volume label unless the privileged 
/OVR keyword is present. 


Files-1l1 (ANSI) Magnetic Tape Format: 


MOU[NT] ddn: [label] [keyword(s)] 


Keywords: 


label 


/ACP=taskname 


/DENS=density 


/FOR 


/FPRO= (system, owner, group, world] 


/OVR 


/OVRFSID 


/OVREXP 


/PARM="user parameters" 


/UIC=[uic] 


/VI 


2-character device name (for example, MT) 


- A unit number. If the command specifies more than one 


unit number, the numbers must be separated by commas 
and enclosed in parentheses, for example, (0,1,2). 


The tape label may be up to six characters in length. 
If the command specifies moe than one label, the labels 
must be separated by commas and enclosed in 
parentheses. The number of labels should be equal to 
or less than the number of units. 


Initially, label-1 must be physically loaded on unit 
ddl:. The remaining labeled tapes may or may not be 
loaded on other units specified in the command. You 
must specify volume labels in the order in which the 
volumes make up the volume set because the system 
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searches for and/or requests each successive volume in 


the 


specified label order. Since the system searches 


according to label, the second volume onward can reside 
on any of the specified units. 


Keyword Definitions: 


ACP 


DENS 


EXT 


FOR 


- /ACP=taskname. The task name of an Ancillary 


Control Processor (ACP) designed to support 
file activity on this volume. 


Default: depends on device type, as 
indicated below: 


For disks and DECtapes, the default ACP 
is ddnnFl. If ddnnFl is not included in 
the system, the default ACP for disks in 
FLIACP (/ACP=FI11ACP) and the default ACP 
for DECtapes is DTAACP (/ACP=DTAACP). 
If DTAACP is not in the system, the 
default is FI11ACP. 


For Files-ll (ANSI) Magnetic tape, 
/ACP=MTAACP 


/DENS=density. The density (Bits Per Inch or 
BPI) of the media loaded on the device. 
Acceptable density values depend on the 
device type as indicated below: 


TE16 800 (or LOW) or 1600 (or HIGH) 
Ts04 1600 
TU45 800 (or LOW) or 1600 (or HIGH) 
TU77 800 (or LOW) or 1600 (or HIGH) 
RX02 , LOW or HIGH 
Defaults: 
TE16 /DENS=800 
TSO4 /DENS=1600 
TU45 /DENS=800 (or LOW) 
TU77 /DENS=800 
RX02 /DENS=HIGH 


/EXT=block-count. This keyword specifies the 
number of blocks a file that exhausts its 
space allocation can extend. 


Default: taken from the home block. . 


/FOR. This keyword indicates a foreign 
volume; the format of the volume and/or the 
ACP that controls the volume is not DEC 
standard. If you specify this keyword, Mount 
performs a syntax check on the entire command 
line, allocates a Volume Control Block (VCB), 
indicates in the Unit Control Block (UCB) 
that a foreign volume is mounted, and 
notifies the appropriate ACP. 


FPRO 


LRU 


OVR 


OVRFSID 
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When mounting a _ foreign volume on an 
RSX-11M-PLUS system, an ACP name is not 
required. However, if you do not specify an 
ACP name, a file system (an ACP) cannot 
access the volume. AbsSence of an ACP name 
permits tasks such as INI, DSC, and BAD 
access to non-FILES-11 volumes. 


When mounting a foreign volume on an RSX-11M 
system, you must specify an ACP name 
(/ACP=taskname). 


/FPRO=[system, owner, group,world]. Keyword 
for default file protection. Access codes 
consist of four 4-code groups in the Access 
Rights word, as follows: 


R = Read 

W = Write 

E = Extend 
D = Delete 
* = Default 


In each instance, the absence of the code 
means that the applicable user is denied the 
access) right. The square brackets are 
required syntax. 


Specify an asterisk (*) in the access’ rights 
word to force the default value for a 
specific group. 


Default: for disk, values taken from volume 
home block; for tape, standard protection 
(RWED, RWED, RWE, R). 


/LRU=FCB-count. The number of directory File 
Control Blocks (FCBs) kept in memory by the 
ACP per volume. These FCBs control access to 
User File Directories (UFDs). The more FCBs 
in memory, the faster a file can be found. 
If the file is in a directory for which the 
FCB is resident, the overhead required to 
open the directory is bypassed. Thus, the 
time required to perform directory operations 
and open files decreases as the number of 
FCBs increases. 


Default: taken from the volume home block. 


Privileged option. /OVR. The /OVR_ keyword 
instructs the Mount command to override label 
processing so that a volume can be mounted 
without specifying a volume label. 


/OVRFSID. The /OVRFSID keyword instructs the 
Mount command to override the existing file 
sequence identifiers on tape volumes. 
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OVREXP - 


PARM a 


UIC = 


UNL - 


VI - 


WIN - 
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/OVREXP. The /OVREXP keyword instructs’ the 
Mount command to override the expiration date 
on the tape volume(s). 


/PARM="user parameters", The /PARM keyword 
instructs the Mount command to pass 
non-standard parameters from the command line 
to a foreign ACP. The user parameter string 
can consist of up to a maximum of 40 
characters enclosed in quotes ("). 


This keyword is valid only in conjunction 
with foreign (/FOR) volumes. 


UIC=[uic]. User identification code = 
[group,member]. Brackets are requried 
syntax. 


/UNL. Specify the volume index file as 
unlocked. When locked, the index file is 
read-only; when unlocked, it is read/write. 
Default: locked. 

/VI. Display the volume information on the 
entering terminal. The information displayed 
is that under which the volume was mounted. 


For random access devices, the volume 
information format is: 


MOUNT ** VOLUME INFORMATION ** 


CLASS = FILES-11 or FOREIGN 

DEVICE = ddnn: 

LABEL = volume label 

UIC = [group,member] 

VOL PRO = [system, owner, group, world] 
FILE PRO = {system, owner, group, world] 
CHARAC = [ATCH, DCF] 

ACP NAME = name 


For magnetic tape, the volume information 
repeats the device and label lines if 
multiple units were specified and omits the 
volume protection and characteristics 
defaults (volume protection and 
characteristics do not apply to magnetic 
tapes). 


/WIN=number. The number of mapping pointers 
to be allocated for file windows. 


Default: If space is available and the 1/0 
optimization option was selected at system 
generation, the entire index file is mapped 
in the window block; otherwise, the number 
of pointers specified in the home block. 


) 


Examples: 


MOU 


>MOU 


MCR COMMANDS 


MOU (Cont.) 


DK 1: AMBER 


Mount the volume on device-unit DK1:. (In this example, the 
optional parameters have not been specified; therefore, 
Mount uses the parameter values in the volume's home block.) 
No volume information is displayed. 


MT(Ost +2) 2 (VOLT VOLE VOLS) 


Mount the volume set on units MTO:, MTl:, and MT2:. 
Initially, VOL1 must be physically loaded on MTO:; the 
first volume in a set must always be loaded on the first 
unit specified in the command. VOL2 and VOL3 may or may not 
be loaded when the command is issued. If they are loaded, 
they can reside on the remaining units in any order (for 
example, VOL3 could be loaded on MT1:). The system searches 
for the next volume in a set by volume label rather than by 
unit number; the order in which volumes are listed in the 
command is the order in which the system searches for and/or 
requests the volumes. If VOL2 and VOL3 are not loaded, the 


system requests each in turn. The volumes can be loaded on 
either MTO:, MTl:, or MT2:. 


IMOU DKi:SY¥SOO4/LRUHS/YI/WIN=20 


Mount the volume labeled SyYS004 on ODKi:. The command 
reserves space for nine directory file control blocks to 
remain in the ACPs pool or system pool, displays the volume 
information, and changes the default window block size for 
files opened on this volume to twenty. 


In RSX-11M systems, you can mount a network channel as a 
native device. For network channels, the Mount command 
informs the network ACP that the device is available for use 
in the network. Mount allocates a communication VCB and 
issues a Mount request to the ACP. 


RSX-11M Network Format: 


MOU[NT] ddn: {/keyword (s) ] 


Network keywords: 


where: 


ddn: 


/PRTCL=network-protocol 
/RCK=name of a redundancy check algorithm 
/TEL=telephone number of a dial-up link 


- is the network device-unit to be made available for use in 
the network. The default ACP is /ACP=NT.... 


Network Keyword Definitions: 


PRTCL - /PRTCL=network-protocol. The name of the network 
line protocol. 


Default: /PRTCL=DDCMP. 
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RCK -/RCK=algorithm-name. The name of the redundancy 
checking algorithm routine. 


Default: /RCK=CRC16. 


TEL -/TEL=number. The telephone number of a line to a 
remote mode. Up to 12 digits may be specified. 


Default: Null. 
NOTE 
In future releases of RSX-11M, native 
network channels will not be supported; 
future releases will require that 
network channels be mounted as foreign. 
Command Error Messages: 


MOU -- ACP NOT IN SYSTEM 


The task specified as ACP or default ACP was not 
installed in the system. 


MOU -- ALREADY MOUNTED 
The specified network device unit was already mounted. 
MOU -- DEVICE NOT DEFINED IN NETWORK 
The specified device unit was not defined in the 
current network topology and therefore could not be 
mounted. 


MOU -- DEVICE NOT IN SYSTEM -dev: 


The Mount command specified a device that had not been 
generated into the system. 


MOU -- DEVICE NOT READY -dev: 


The device specified in the command, although generated 
into the system, was not physically present in the host 
configuration. 


MOU -- DEVICE SPECIFIED TWICE 
The Mount command specified the same tape device-unit 
twice. 

MOU ~-- DISMOUNT IN PROCESS 


The ACP of the device to be mounted is in the process 
of deallocating control blocks for the device. Reissue 
the command. 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MCR COMMANDS 


MOU (Cont.) 


DRIVER NOT LOADED 


The driver of the device to be mounted has not been 
loaded. Load the appropriate driver and reissue the 
Mount command. (See the description of the Load 
command. ) 


FAILED TO ATTACH DEVICE -dev: 


The device-unit specified in the command was attached 
by another task and could not be mounted. 


HOME BLOCK I/0 ERROR 
An I/O error was detected in trying to read the home 
block. This message usually indicates that the volume 
is not ready. Wait until it is ready and reissue the 
command. 

ILLEGAL KEYWORD COMBINATION 
The Mount command specified conflicting keywords. 


INDEX FILE I/O ERROR 


Mount could not read either the index file header or 
the storage allocation file. 


MOUNT ERROR FROM ACP xxx. 


The magnetic tape ACP (MTAACP) detected an error while 
trying to mount the volume set. The following is a 
list of the MTAACP error code numbers and their 
respective meanings. 


Decimal Value Meaning 
6 Get command line error 
7 Syntax error 
8 Bad device 
il Wrong volume (incorrect label) 
12 All units must be TU16s 
13 Not ANSI format 
17 Privilege violation 
18 Units have different track 


specifications (cannot mix 7- and 9- 
track units) 
19 Message task (F11MSG) not installed 


(See the IAS/RSX-11 I/O Operations Reference Manual for 
a further discussion of MTAACP error codes.) 
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MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MULTI-UNIT DEVICE NOT TAPE 


The command specified multiple units that are not tape 
drives. 


NT DEVICE NOT MOUNTED 


The device NT: was not mounted. This device must 
always be mounted before any other device in a network. 


NOT FILE STRUCTURED DEVICE 


The specified device was not supported as a Files-11l 
device (including ANSI magnetic tape). 


NOT MOUNTABLE DEVICE 


The specified device was not supported as a network 
device. 


OTHER VOLUME MOUNTED ~dev: 
An attempt was made to mount a volume on a device that 
already had a mounted volume. In multiuser protection 
systems, only random access devices can be mounted by 
multiple users. 

PARAMETER CONFLICTS WITH MOUNTED VOLUME 
An attempt was made to mount a mounted volume with 
keyword parameters that conflict with those values 
specified when the volume was initially mounted. 

STORAGE BIT MAP FILE I/O ERROR 


An I/O error was encountered while reading the storage 
allocation file. 


TASK NOT ACP 


The task specified as an ACP did not have the 
characteristics of an ACP. 


UNDEFINED DENSITY SELECTION 
The command specified an illegal density value. 
UNIT DOES NOT SUPPORT DENSITY SWITCH 


The command specified a device which does not have 
multiple density capability. 


UNIT DOES NOT SUPPORT HIGH/LOW DENSITY SELECTION 


The command specified a device for which the High and 
Low keywords are undefined. 
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MOU -- UNIT DOES NOT SUPPORT 800 BPI 


The command specified a tape drive 
support 800 BPI. 


MOU -- UNIT DOES NOT SUPPORT 1600 BPI 


The command specified a tape drive 
support 1600 BPI. 


MOU -- UNSUPPORTED FILE HEADER FORMAT 
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that does not 


that does not 


The volume home block does not conform to FILES-11 
format. This may indicate a corrupted volume. 


MOU -- WRONG VOLUME LABEL 


The volume label and the label specified in the command 


did not match. 
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PARTITION DEFINITIONS 


This command displays on the entering terminal a description of each 
memory partition in the system. 


In an RSX-11M system, the display consists of five columns” that 
specify: 


1. Partition name 

2. Partition base address (octal) 

3. Partition size (octal) 

4. Partition kind: main partition (MAIN), or subpartition (SUB) 


5. Partition type: 


TASK for user-controlled 
COM for common 

DEV for device registers 
SYS for system-controlled 


taskname for task region 
DYNAMIC for dynamically created region 
DRIVER for region occupied by a loadable driver 


COM partitions are used for resident libraries and common data _ areas. 
DEV partitions are used to allow tasks to communicate with specific 
device registers, such as the UDC and ICS/ICR-11 industrial control 
subsystems. See Chapter 1 for a description of system and 
user-controlled partitions, as well as _ subpartitions. Dynamic and 
task regions are defined in the RSX-11M/M-PLUS Executive Reference 
Manual. See the description of the Load command for information about 
loadable drivers. 


wv 
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Format: 
PAR[TITIONS] 

Examples: 

RSX-11M systems 


Name Base Size Kind Type 


>PAR 
LDR QOOoOgdd OOOOOO MAIN TASK 
SYSPAR 120000 010000 MAIN TASK 


FCPPAR 130000 026000 MAIN TASK 

PMDPAR 156000 020000 MAIN TASK 

SPLPAR iSG000 010000 SUB TASK 

DRYPAR 176000 014000 MAIN SYS . 
176000 001600 SUB DRIVER ~ DBs 
177600 900500 SUB DRIVER ~ DS: 
2900300 901000 SUB DRIVER ~ DK: 
2013900 O0O1100 SUB DRIVER - OT: 
202400 001000 SUB DRIVER ~- LP: 
2039400 003100 SUB DRIVER - MM: 

GEN 212000 S46000 MAIN SYS 
212000 013400 SUB (RMDEMO) 
229400 045700 SUB (.,..EDI) 
302100 O384200 SUB (4++AT.) 
336900 117100 SUB (...TKB) 
455400 045700 SUB (EDITI3) 
S29900 010000 SUB (...578) 
GOLSO0 117100 SUB (...MAC) 


RSX-11M-PLUS systems 


»PAR 
SYSPAR 117734 O0174400 00010000 MAIN 
O6S2390 OO17K4d00 OOO10000 TASK <TKTN 
GPLPAR 117767 OO2Odd00 00012000 MAIN 
DRYPAR 117624 OO216400 00140000 MAIN 
117340 OO21G6400 00003100 DRIVER (DBs) 


PAR (Cont.) 


LDRPAR 


TSTPAR 
SECPOL 
GEN 


117274 
117164 
117120 
036314 
116744 
116700 
116634 
116550 
116504 
116440 
116374 
N36044 
O3BSs04 
117569 
116054 
117514 
117450 
117404 
115454 
O7Bda0 
O32274 
OBO774 
O37210 
Od5104 
ad0240 
Od3300 
aQdda74 
OB2Z254 
O61340 
o61674 
OBL774 
NBIO5O 
o70100 
Q71114 
O37474 
O72244 
OG2100 
N37540 
O643534 
037724 
O70574 


oo0z2z21500 
ooz26100 
O0227400 
ONZ33400 
oOo236400 
OO237500 
002439300 
Oo300B800 
Oo31G64d00 
00g317700 
OOBZL200 
90321300 
Og322600 
OO356400 
OoO356400 
00361200 
oo0ad21200 
oodd3200 
OO443200 
OoS34000 
Oo542600 
oag571400 
OoB20100 
QOBSE62Z00 
00716200 
OL007000 
O1077600 
O1170400 
O1230400 
01242500 
OLZ54600 
O1313700 
01401400 
01437000 
O1474400 
O1571100 
01631100 
01715600 
QO2ZO50300 
92143000 
O2340500 
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ooog1Tg00 
oOogg01300 
oogo0do00 
OOoO1GOO 
Ooogg1 Log 
OoOd BOO 
OOd gS 300 
OooLSE00 
Oooo1300 
90001300 
OOdOgaTOD 
Qog001300 
OO0N3Z00 
oo0dg02600 
OoOdg2bO0 
oOoogdoo0a 
Oogz2000 
04734600 
ooo 70600 
oOooNsgooo 
Qo003800 
Oogz0100 
OOo IG 1G0 
oood2z6400 
ooo70G00 
Oodg7OB00 
oOoOoO7OB00 
ooOOdoooo 
OoOOLTZ1O0 
a001tz100 
OO037100 
QO0037109 
Og035400 
OOO3S4d00 
00074500 
Qoo2zE500 
oOon0B4500 
OoL02700 
OON33500 
00194300 
Ood0d1700 


DRIVER (DK:> 
DRIVER (DS:) 
DRIVER (DM:) 
DRIVER (DX:s) 
DRIVER (LP: ) 
DRIVER (MMs) 

RW COM !TTCOM ! 
DRIVER (TTs) 
DRIVER (RD) 
DRIVER (YT:) 
DRIVER (NL:) 
DRIVER (DTs) 
DRIVER (DR: ) 
MAIN 

TASK fee e+ LDR? 
MAIN 

SEC POOL 

MAIN 

TASK SFLLACP? 
TASK 2TT36 

RO COM +...EDI+ 
TASK ZOMGe ee & 


TASK SHRO wae & 
TASK =RMDEMO > 
TASK LDSOOF1 = 
TASK ADSOLFL> 
TASK LLSTACP = 


TASK iSYSLOG? 
TASK HLPPOQ  & 
TASK LLPPL 
TASK <BAP2 = 
TASK <BAPIL = 
TASK LAT, T3G% 
TASK LAT WB 


TASK SEDTTS 
TASK 2 PARYS 
TASK 2TT47 
TASK H{EDITEZ9 2 


TASK LTTFG 
RW COM !RMSRES! 
TASK LLOGTI7 = 
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RESUME 

The Resume command continues execution of a previously suspended task. 
A nonprivileged user can issue the Resume command only for tasks 
initiated from the entering terminal. A privileged user can direct 
the Resume command to any suspended task. 

Format: 


RES[UME] taskname [/TERM=TTnnn: ] 


where: 


Example: 
+RES XKE 
Resume task XKE. 
Note: 


A task cannot suspend any task other than itself. The Resume 
command allows such a suspended task to proceed. 


Command Error Message: 
RES -- TASK NOT SUSPENDED 


The task used as the argument of the Resume command 
was not suspended. 


RUN 


RUN 
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The Run command initiates the execution of a task. 
cause a task to be: 


Started immediately 


Started at a time increment from now 


Started at a time increment from clock unit synchronization 


Started at an absolute time of day 


Installed, immediately run, and removed on exit 


All these options, except install-run-and-remove, are 
or without rescheduling. 


Run has 


Formats: 


l. 


2Q% 


five format variations, as described below. 


Run immediately. 
RUN taskname [/RSI=magu] {[/UIC=[uic]]} 


where: 


taskname - A l- to 6-character task name. 


RSI - The reschedule interval -- The format is 
same as for dtime, which is detailed below 
under format 2. The reschedule 
specifies how often the task is to be rerun. 
Thus, each time the specified 
time lapses, an initiation request is made 


for the specified task. 


Default: no rescheduling. 


UIC - (Privileged option in multiuser 
systems only.) The uic has the format [g,m] 
where g and m represent the group and 
numbers respectively; legal group and member 
numbers range from 1 through 
square brackets are required syntax. 


the UIC under which the 


requested. The UIC determines which files 


the task may access. 


Default: the value established 


terminal from which the 
entered. 


Run at a time increment from now. 
RUN taskname dtime [/RSI=magu] [/UIC=[uic]]} 


where: 


taskname = A 1l- to 6-character task name. 


4-80 


available 


protection 


dtime 
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The time at which the task will be initiated 
in time units from command issuance. It 
follows the form magu. 

A time parameter consists of two fields: 


a. A magnitude field 


b. A units field 


where: 
INag = The magnitude 
u = Units, one of the following letters: 


many 


The legal value of the magnitude is related 
to the value of the units field, which is 
encoded as: 


T = Ticks -- A tick is a clock 
interrupt, and the rate at which 
interrupts occur depends on the type 
of clock installed in the system. 


For a line frequency clock, the tick 
rate is either 50 or 60 per second, 
corresponding to the line frequency. 


For a programmable clock, a maximum 
of 1000 ticks per second is 
available. (The frequency is 
selected at system generation.) 


S = Seconds 
M = Minutes 
H = Hours 


The magnitude is the number of units to be 
clocked, but the magnitude value cannot 
exceed 24 hours in the specified units. Tf 
the magnitude is equal to 0, then the RSI is 
set to 1. For example, /RSI = OH is 
equivalent to /RSI = 1H. 


Units = T -- Any positive value is valid 
(maximum of 15 bits). 


Units = S -- Any positive value is valid 
(maximum of 15 bits). 

Units = M -- The maximum magnitude is 
1440(10). 
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4. 


Units = H -- The maximum magnitude is 
; 24(10). 
RSI = See Format 1, above. 
UIC = See Format 1, above. 


Run at a time increment from clock unit synchronization. 

The system determines the task start-time by waiting for the 
first specified time unit (hour, minute, second, tick) to 
increment and then waiting for the specified time to elapse. 


RUN taskname sync [dtime] [/RSI=magu] [/UIC=[{uic]] 


where: 

taskname = A 1l- to 6-character task name. 

sync = H = synchronize on the next hour 
M = synchronize on the next minute 
S = synchronize on the next second 
T = synchronize on the next tick 

dtime = As defined in Format 2, above; dtime, if 
present, is added to the synchronization unit 
to produce the actual run time for running 
the task. 

RSI = See Format 1, above. 

uIc = See Format 1, above. 


Run at an absolute time of day. 


RUN taskname atime [/RSI=magu] [/UIC=[uic] ] 


where: 

taskname = A 1=- to 6-character task name. 

atime = Absolute time of day at which to initiate 
this task. Input format is hh:mm:ss. 
hh = hours (decimal assumed); 
mm = minutes (decimal assumed), and 
ss = seconds (decimal assumed). 

RSI = See Format 1, above. 

UIC = See Format 1, above. 


Install, run immediately, and remove on exit. 


When Run tries to start a task as a type 1 request, it 
searches the system task directory (STD) for the task; if it 
finds the entry, it proceeds to run it. However, if Run does 
not locate the task, it attempts to install a task whose 
filename is given as the task name. Run determines which 
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directory to look in for this file by the presence or absence 
of a leading $ immediately before the task name 
specification. If you do not specify $, Run searches the UIC 
of the terminal requesting the task on device SY:. If you 
specify $, Run searches the system directory on device LB:. 
The SET /SYSUIC command defines the system directory; 
however, conventional values are [1,50] for an unmapped 
System and [1,54] for a mapped system. In an RSX-11M-PLUS 
System, if you specify $ and the file cannot be found under 
SYSUIC, Run searches the library directory on device LB:. By 
convention, LIBUIC is [3,54]. 


RUN [ddn:][$]filespec [/keyword(s) ] 
Keywords: 

/CKP=option 

/PAR=pname 

/PMD=option 

/PRI=number (Privileged) 

/ROPAR=pname (RSX-11M~PLUS systems) 

/SLV=option 

/TASK=taskname 


/UIC={[group, member] 


where: 

ddn: - Device-unit on which task image file 
resides, 

$ - Specifies that the file can be found 
under the system UIC on device LB: 
(if ddn: is not specified). 

filename - The name of the task-image file to be 
run, 

CKP - /CKP=option. Checkpoint option. The 


two options are YES and NO. If 
/CKP=YES (default for checkpointable 
tasks), checkpointing is allowed. If 
/CKP=NO, checkpointing is disabled for 
the task. 


The /CKP keyword overrides the /CP 
switch specified at task build. 
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PAR 


PMD 


PRI 


SLV 
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On systems that support the dynamic 
allocation of checkpoint space, the 
task image file does not need to 
contain allocated checkpoint space. 
The presence of the /CKP=YES keyword 
instructs the system to allocate 
checkpoint space for the task when 
required from a checkpoint file. 


/PAR=parname. Parname specifies the 
partition in which the task is to be 
installed. 


Default: Partition specified at task 
build. 


/7PMD=option. Post-Mortem Dump option. 
The two options are YES and NO. If 
PMD=YES, a post-mortem dump is 
requested for the task if it aborts 
because of an SST error condition. If 
PMD=NO (the default from a 
task-build), no dump is requested at 
SST abort time. To generate a dump, 
the post-mortem dump task PMD... must 
be infStalled in the system. This 
keyword overrides’ the /PM switch 
specified at task-build time. 


Default: specified at task-build 
time. 


/PRI=number. Privileged keyword. 
Priority number. The value range is l 
through 250(10). Standard number 
conventions apply; octal by default, 
decimal if followed by a period. 


Default /PRI=50. 


/SLV=option. Slave task option. The 
two options are YES and NO. If the 
command specifies /SLV=YES, data sent 
to the installed task is marked with 
the TI: of the sending task. When 
the installed task receives the data, 
the system sets the task's TI: to 
that associated with the data. This 
keyword overrides’ the /SL switch 
specified at task build. 
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If the command specifies /SLV=NO the 
TI: of the task does not change when 
receiving data. 


Default: Specified at task build. 


TASK ~ /TASK=taskname. The specified task 
name is to be assigned temporarily to 
the task while it is running. If 


taskname is not found in the STD, MCR 
names it TTnn by default, where nn is 
the unit number of the requesting 
terminal. 


UIC - /UIC=[uic]. The square brackets are 
required syntax. This is the UIC 
under which the task will be 
requested. 


Default: The value established for 
the terminal that issues the RUN 
command. 


Examples: 


> RUN XKE 15M 


Run task XKE 15 minutes from command issuance. 


*RUN XKE LSM/RST=90S/UTC=C3+1] 


Run task XKE 15 minutes from command issuance, rescheduling 
it every 90 seconds, with a UIC code of [3,1]. 


=IRUN DK2: $MAC 


Run task in file DK2:MAC.TSK from the system directory. The 
task is automatically installed, run, and removed on exit. 


If the command is a Run Immediately, it establishes TI: as 
the terminal from which the task was initiated. Otherwise, 
the system sets the TI: terminal to CO:. 


A Run Immediately, if specified without the /RSI option and 
terminated with an ESCape character instead of a carriage 
return, echos the default prompt when the requested task exits 
and not when MCR has finished initiating the task. This 
facility enables the operator to determine when a task that is 
not producing output on a terminal has exited. 


The install, run, and remove form establishes the terminal 
from which the command was initiated to be the TI: terminal 
and causes the default prompt to be displayed on TI: when the 
task exits. This form of the command is especially useful 
when the space available in the Dynamic Strorage Region (DSR) 
is small, since the memory necessary for a Task Control Block 
(TCB) returns to the DSR when the task exits. 
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Command Error Messages: 
RUN -- INVALID TIME PARAMETER 
A specified time field was incorrect. 
RUN ~- TASK BEING ABORTED 
A request for the execution of a task was made, but 
the subject task was being aborted either because of 
an unrecoverable error or an Abort directive issued by 
the operator. 
mm, 
ar, 
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SET 


The Set command dynamically alters device characteristics and/or 
displays system-wide status and statistics. 


A nonprivileged user can only alter local terminal (device TI:) or 


private device characteristics. Privileged users can alter device 
characteristics for any terminal in the system as well as_ system 
statistics. Both privileged and nonprivileged users can display 


status or statistics. 


The following two lists describe all the available options under the 
appropriate privilege heading. 


Nonprivileged options: 


e Establish certain terminal characteristics for the issuing 
terminal only 


° Set the default UIC for the issuing terminal 


e Display the status (determined by the keyword specified) of 
all terminals 


e Display statistics about system dynamic memory 
Privileged options: 


e Establish device characteristics for any terminal in the 
system 


e Establish the default UIC for any terminal in the system 

e Establish the system UIC and, in an RSX-11M-PLUS system, the 
library UIC used by the Load command and the 
install-run-remove option of the Run command 

e Set the privilege status of any terminal in the system 


e Set any terminal to slave status 


e Set any device to public status so that any system user can 
access the device 


e Create partitions and subpartitions 
e Add space to the dynamic core pool 
e Enable write check on devices that support it 


e Specify the maximum number of I/O packets to be preallocated 
in order to optimize I/O performance 


e Specify the maximum size to which a task can extend itself by 
means of the Extend Task system directive 


e Enable or disable the ability to log onto terminals in a 
multiuser protection system 
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Improper use of the Set command from a privileged terminal can result 
in a situation in which privileged operator input will not be 
accepted. Avoid the following two situations: 


e All privileged terminals in the system are set to slave and 
cannot enter unsolicited input to MCR. Nonprivileged 
terminals cannot enter privileged commands and _ therefore 
cannot reset the privileged terminals to nonslave. See the 
description of the /SLAVE keyword below. 


e The buffer length of all the-nonslaved, privileged terminals 
is shorter than 14 bytes. The terminal buffer is then too 
short to enter many important commands required to continue 
system operation or to alter the status of other terminals. 
See the description of the /BUF keyword below. 

A number of Set command keywords (/CRT, /ESCSEQ, /HOLD, /LOGON, 
/LOWER, /MAXEXT, /MAXPKT, /OVLP, /PUB, and /WCHK) are features that 
you must include at system generation. If you did not include support 
at system generation, the the specified keyword has no effect. Also, 
some keywords (/EBC, /ECHO, /FDX, /FORMFEED, /HFILL, /HHT, /LINES, 
/RPA, /TYPEAHEAD, /VFILL, and /WRAP) are only supported with the full 
duplex terminal driver. The full duplex terminal driver is a SYSGEN 
option in RSX-11M systems, but is always included in an RSX-11M-PLUS 
system. 


Format: 
SET /keyword=values 
Only one keyword per command is permitted. You can prefix most 
keywords with NO to negate or disable the function of the 
keyword. Exceptions are /BUF, /MAXEXT, /MAXPKT, /POOL, /SPEED, 
/SYSUIC, and /UIC; the system returns a syntax error whenever NO 
precedes one of these keywords. 
Device Characteristics Keywords: 
/BUF=dev: [size] 
/CRT[=TTnns ] 
/DCL[=TTn:] (RSX-11M-PLUS systems only) 
/EBC[=TTnn: ] 
/ESCSEQ [=TTnn: ] 
/ECHO[=TTnn: ] 
/FDX[=TTnn: ] 
/FORMFEED[=TTnn: ] 
/HFILL=TTnn: [value] 
/HHT[=TTnnsz J 


/HOLD[{=TTnn: J 
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/LINES=TTnn: [value] 
/LOWER[=TTnn:]} 
7MCR[(=TTn:] (RSX-11M-PLUS systems only) 
/OVLP[=ccn:] (RSX-11M-PLUS systems only) 
/PRIV[=TTnn: J 
/PUB[=dev: ] 
/REMOTE[=TTnn: ] 
/RPA[=TTnn: ] 
/SLAVE[=TTnn: ] 
/SPEED=TTnn: [recv: xmit] 
/TERM=TTnn: (value]} 
/TYPEAHEAD [=TTnn: ] 
/UIC{=uic[:TTnn:)] 
/UIC(=TTnn:] 
/VFILL[=TTnn: ] 
/WCHK [=dev: ] 
/WRAP [=TTnn: ] 
Keyword Definitions: 


BUF - /BUF=dev: [size]. Set or display the 
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default buffer 


size of the specified device. A nonprivileged user can 


display the buffer size of any device, 


but can alter 


only the buffer size of device TI:. A privileged user 


can set the buffer size for any device. 


The specified 


size must be greater than 0 and less than or equal to 
255(10). If dev: is a terminal, size must be greater 
than 2 and less than or equal to 255(10). /BUF is 


particularly useful for defining line 
(80. or 132. columns). 


printer width 


When size is omitted, the system displays at the 


issuing terminal the buffer size of 
device. 


Example: 


“SET /BUFFLPOs 
BUFFELPO: 132. 


Display the current buffer size of LPO:. 
SET /BUF=TT1L:40, 


Sets TTl: buffer size to 40(10). 
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CRT 


NOCRT 


- /CRT[=TTn:] where TTn: is a Cathode Ray Tube (CRT) 


terminal. The /CRT keyword defines the terminal as a 
CRT and enables the backspace deletion option. Typing 
the RUBOUT or DELETE key moves the printing position 
one space to the left and erases any character 
displayed in that position. 


A nonprivileged user can display all terminals defined 
as CRTs, but can only define TI: as a CRT. A 
privileged user can define any terminal as a CRT. 


When the keyword omits =TTn:, the system displays at 
the issuing terminal all terminals defined as CRTs. 


Examples: 
*SET /CRT=TTO: 


Enables the backspace deletion option on the display 
terminal TT3:. 


*SET /CRT 
CRT=TT3: 
CRT=TT4: 


Displays all terminals that have the backspace deletion 
option enabled. 


/NOCRT[=TTn:] where TTn: is a Cathode Ray Tube (CRT) 
terminal. The /NOCRT keyword deletes the CRT status of 
the specified device and disables the backspace 
deletion option. 


A nonprivileged user can display all terminals not 
defined as CRTs, but can only delete CRT status for 
device TI:. A privileged user can define any terminal 
as other than a CRT. 


When the keyword omits =TTn:, the system displays at 
the issuing terminal all the terminals that are not 
defined as CRTs. 
Examples: 

SET /NOCRT=TT4s: 
Disables the backspace deletion option at TT4: 

>SET /NOCRT 

NOCRT=TTO: 

NOCRT=TT1: 

NOCRT=TTa: 

NOCRT=TT4: 


Displays all terminals that have the backspace deletion 
option disabled. 
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- /EBC[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /EBC keyword enables the 
8-bit character option. The full duplex terminal 
driver passes all eight bits of the input characters to 
the specified terminal. 


A nonprivileged user can display all terminals that 
have the option enabled, but can only enable EBC for 
TI:. A privileged user can enable the EBC option for 
any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all the terminals that have the 
EBC option enabled. 
Examples: 

»SET /EBC=TT3: 
Enables the EBC option for terminal TT3:. 


>SET /EBC 
EBC=TT3: 


Displays all terminals that have the EBC option 
enabled. 
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/NOEBC{=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /NOEBC keyword disables the 
8-bit character option. Before passing the input 
characters to the device, the full duplex terminal 
driver removes the parity bits. 


A nonprivileged user can display all terminals that 
have the option disabled, but can only disable EBC for 
TI:. A privileged user can disable EBC for any 
terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all the terminals that have the 
EBC option disabled. 


Examples: 


3SET /NOEBC 
NOEBC=TTOs 
NOEBC=TT1: 
NOEBC#TT2: 
NOEBC=TT4: 


Displays all terminals that have the EBC option 
disabled. 


"SET /NOEBCSTTS: 
Disables the EBC option for terminal TT3: 


7ESCSEQ[=TTn:] where TTn: is a terminal. The /ESCSEQ 
keyword enables the recognition of escape sequences 
from the specified terminal. The terminal driver 
treats the ESC character as the beginning of an escape 
sequence rather than as a line terminator. See the 
RSX-11M/M-PLUS I/O Drivers Reference Manual for further 
information about escape sequences. 


A nonprivileged user can display all terminals that can 
send and receive escape sequences, but can only declare 
TI: able to send and receive escape sequences. A 
privileged user can establish escape recognition for 
any terminal. 


When the keyword omits =TTn:, the system displays at 
the entering terminal all the terminals that can send 
and receive escape sequences. 

Examples: 


SET /ESCSEQ=TT3: 


Establishes TT3: as a terminal that can send escape 
sequences, 


3SET /ESCSEQ 
ESCSEQ=TTQ: 


Displays all terminals that can send and receive escape 
sequences. 
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NOESCSEQ - /NOESCSEQ[=TTn:] where TTn: is a terminal. 
The /NOESCSEQ keyword disables the recognition of 
escape sequences at the specified terminal. 


A nonprivileged user can display all terminals that do 
not recognize escape sequences, but can only disable 
the function for device TI:. A privileged user can 
disable escape recognition for any terminal. 


When the keyword omits =TTn:, the system displays at 
the issuing. terminal all the terminals with escape 
recognition disabled. 


Examples: 


*SET /NOESCSEQ 
NOESCSEQ=TTO: 
NOESCSEQ=TT1: 
NOESCSEQ=TT2: 
NOESCSEQ=TT4: 


Displays all terminals that cannot send or receive 
escape sequences, 


+SET /NOESCSEQ=TT3: 
Disables escape sequence support at TT3:. 
/ECHO{=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /ECHO keyword instructs the 
full duplex terminal driver to display each character 
typed on the entering terminal. 
A nonprivileged user can display all terminals that 
echo typed characters, but can only enable the echo 
option for TI:. A privileged user can enable the echo 
option for any terminal. 
When the keyword omits =TTnn:, the system displays at 
the entering terminal all the terminals that have the 
echo option enabled. 
Examples: 

“SET /ECHO=TT3: 
Enables the echo option for terminal TT3: 

°SET /ECHO 

ECHO=TT1: 

ECHO=TT3: 


Displays all terminals that have the echo option 
enabled. 
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- /NOECHO[=TTnn:}] where TTnn: is a terminal. Full 


duplex terminal driver only. The /NOECHO keyword 
instructs the terminal driver to inhibit the display of 
all input characters typed on the specified terminal. 


A nonprivileged user can display all terminals that do 
not echo typed characters, but can only disable the 
echo option for TI:. A privileged user can disable the 
echo option for any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have the echo 
option disabled. 


Examples: 


“SET /NOECHO 
NOECHO=TTO: 
NOECHO=TT2: 
NOECHO=TT4: 


Displays all terminals that do not echo typed 
characters. 


“SET /NQECHO=TT3: 
Disables the echo option for terminal TT3:. 
/EDX[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /FDX keyword instructs the 
full duplex terminal driver to accept input from _ the 
specified terminal while simultaneously outputting to 
it. 
A nonprivileged user can display all full duplex 
terminals, but can only enable the option for TI:. A 
privileged user can enable the full duplex option for 
any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all full duplex terminals. 


Examples: 
“SET /FDX=TT3: 


Declares that TT3: is a full duplex terminal. 


*SET /FDX 
FDX=TT1: 
FDX=TT3: 


Displays all full duplex terminals. 


/NOFDX[{=TTnn:] where TTnn: is a terminal. The /NOFDX 
keyword disables the full duplex option; the terminal 
driver does not simultaneously process input and output 
from the specified terminal. 
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A nonprivileged user can display all terminals that 
have the option disabled, but can only disable full 
duplex operation for TI:. A privileged user can 
disable full duplex operation for any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all the terminals that have the 
full duplex option disabled. 


Examples: 
SET /NOFDX 
NOFDX=TTO: 
NOFDX=TT2: 
NOFDX=TT4: 


Displays all terminals that do not process input = and 
output simultaneously. 


"SET /NOFDK=TT3: 
Disables the full duplex option for terminal TT3:. 
/FORMFEED[=TTnn:] where TTnn: is a terminal. Full 
duplex terminal driver only. This keyword indicates 
that the specified terminal has a hardware formfeed. 
A nonprivileged user can display all terminals that 
have a hardware formfeed, but can only declare it for 
TI:. A privileged user can specify any terminal. 
When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have a 
hardware formfeed. 
Examples: 


“SET /FORMFEED 
FORMFEED#TTIs 


Displays all terminals that have a hardware formfeed. 
*SET /FORMFEED=TT3: 

Declares that TT3: has a hardware formfeed. 

/NOFORMFEED(=TTnn:] where TTnn: is a_ terminal. Full 

duplex terminal driver only. This keyword indicates 

that the specified terminal does not have a hardware 

formfeed. 

A nonprivileged user can display all terminals that do 

not have hardware formfeeds, but can only declare this 


for TI:. A privileged user can specify any terminal. 


When the keyword omits =TTnn:, the system displays all 
terminals that do not have a hardware formfeed. 
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Examples: 


*SET /NOFORMFEED 
NOFORMFEED=TTOQ: 
NOFORMFEED=TT2: 
NOFORMFEED=TT4: 


Displays all terminals that do not have hardware 
formfeeds. 


3SET /NOFORMFEED=TT3: 
Declares that TT3: does not have a hardware formfeed. 


/HFILL=TTnn: [value] where TTnn: is a terminal and 
value is a number in the range of 0-7 inclusive. Full 
duplex terminal driver only. This keyword specifies 
the number of fill characters that the full duplex 
terminal driver places after a carriage return when 
outputting to a terminal. 


A nonprivileged user can display the number of fill 
characters for any terminal, but can only change the 
value for TI:. A privileged user can specify the 
number of fill characters for any terminal. 


When the keyword omits the value parameter, the system 
displays at the entering terminal the £111 character 
value for the specified terminal. 


Examples: 


°SET /HFILL=TTQ: 
HFILL#=TT3:20 


Displays the number of fill characters for TT3:. 


PSET /HFILL=TT3:3 


Specifies that three fill characters follow a carriage 
return at terminal TT3:. 


/HHT[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. This keyword indicates to the 
full duplex terminal driver that the specified terminal 
has a hardware horizontal tab. 


A nonprivileged user can display all terminals that 
have a hardware horizontal tab, but can only declare it 
for TI:. A privileged user can specify any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have hardware 
horizontal tabs. 


NOHHT 


HOLD 
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Examples: 


>SET /HHT 
HHT=TT4: 


Displays all terminals that have hardware horizontal 
tabs. 


*SET /HHT=TT3: 
Declares that TT3: has hardware horizontal tabs. 


/NOHHT[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /NOHHT keyword indicates 
that the specified terminal does not have hardware 
horizontal tabs. 


A nonprivileged user can display all terminals that do 
not have hardware horizontal tabs, but can only declare 
this for TI:. A privileged user can specify any 
terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that do not have 
hardware horizontal tabs. 


Examples: 


>SET /NOHHT 
NOHHT=TTO: 
NOHHT=TTi: 
NOHHT=TTe: 


Displays all terminals that do not have hardware 
horizontal tabs. 


SET /NOHHT=TTS: 


Declares that TT3: does not have hardware horizontal 
tabs. 


/HOLD[=TTn:] where TTn: is a CRT display terminal. 
The /HOLD keyword enables hold-screen mode at the 
specified terminal. When hold-screen mode is enabled, 
the terminal displays output one screenful at a time. 
The screenful of output remains on the screen until the 
user types SHIFT/SCROLL (types the SCROLL key while 
pressing the SHIFT key). The terminal then refills the 
screen. The user can also advance the screen contents 
one line at a time by typing the SCROLL key. 


Hold-screen mode is useful when copying files to 
terminals that normally transmit output at very high 
baud rates. Note, however, that hold-screen mode may 
not be appropriate for use with certain types of 
programs (editors or terminals using different speed 
for input and output, for example). 
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A nonprivileged user can display all terminals 
currently in hold-screen mode, but can only place TI: 
in hold-screen mode. A privileged user can place any 
terminal in hold-screen mode. 


If the keyword omits =TTn:, the system displays at the 
issuing terminal all the terminals currently in 
hold-screen mode. 


Examples: 
°SET /HOLD=TT3: 


Enables hold-screen mode on CRT terminal TT3:. The 
terminal erases its screen and positions the cursor at 
the top left (home) of the screen. 


»SET /HOLD 
HOLD*TT3: 


Displays all terminals that have hold-screen mode 
enabled. 


/NOHOLD[=TTn:] where TTn: is a CRT display terminal. 
The /NOHOLD keyword disables hold-screen mode at the 
specified terminal. 


A nonprivileged user can display all terminals not in 
hold-screen mode, but can only disable the function at 
TI:. A privileged user can disable hold-screen mode 
for any terminal. 


If the keyword omits =TTn:, the system displays at the 
issuing terminal all CRT terminals that have disabled 
hold-screen mode. 
Examples: 

“SET /NOHOLD=TT3: 
Disables hold-screen mode at terminal TT3:. 

»SET /NOHOLD 

NOHOLD=TTO: 

NOHOLD=TT3: 


Displays all terminals that have hold-screen mode 
disabled. 


- /LINES=TTnn: [value] where TTnn: is a terminal and 


value is a decimal number in the range 1-255 inclusive 
that establishes the number of lines per page. This 
option requires the full duplex terminal driver. 
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A nonprivileged user can display the number of lines 
per page for any terminal, but can only specify the 
number for TI:. A privileged user can specify the 
number of lines per page for any terminal. 


When the keyword omits the value parameter, the system 
displays at the entering terminal the number of lines 
per page for the entering terminal. 


Examples: 


SET /LINES=TT3: 
LINES=TT3s24 


Displays the number of lines per page for TT3:. 
SET /LINES#TT3:20 
Specifies the number of lines per page for TT3:. 


/LOWER[=dev:] where dev: is either a terminal or line 
printer. Specifies that lower-case characters are not 
to be converted to upper case when they are received 
from the specified terminal or line printer driver. 


A nonprivileged user can display all devices that do 
not convert lower-case characters to upper case, but 
can only define this function for TI:. A privileged 
user can enable this function for any terminal or line 
printer. 


If the keyword omits =dev:, all devices for which 
lower-case characters are not converted are displayed. 


Examples: 
"SET /LOWER=TT3¢ 


Inhibits conversion of lower-case characters to upper 
case when they are received from TT3:. 


=*SET /LOWER 
LOWER=TT1: 
LOWER=TT3s 


Displays all devices for which lower-case characters 
are not converted to upper case. 


/NOLOWER[=dev:] where dev is either a terminal or a 
line printer. Resets the device characteristics so 
that lower-case characters received on input are 
automatically converted to upper case and echoed or 
printed as upper case. 


A nonprivileged user can display all the devices that 
perform this conversion, but can only specify this 
function for TI:. A privileged user can specify any 
terminal or line printer. 
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If the keyword omits =dev:, the system displays all 
devices for which conversion to upper case is 
specified. 


Examples: 


*SET /NOLOWER 
NOLOWER=TTO: 
NOLOWER=TT2: 
NOLOWER=TT4: 
NOLOWER=LPi: 


Displays all devices that automatically convert lower 
case characters to upper case, 


“SET /NOLOWER=TT3: 


Resets TT3: so that lower-case characters are 
converted to upper case 
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/PRIV[=TTn:]. Sets the specified terminal to 
privileged status. 


A nonprivileged user can only display the terminals 
that have privileged status. A privileged user can set 
any terminal to privileged status. 


If the keyword omits =TTnn:, the system displays all 
privileged terminals. 


Examples: 
3SET /PRIVETTIs 


Sets the status of TTl: to privileged. 


ESET /PRIV 
PRIVeTTO: 
PRIV=TT1: 


Displays all privileged terminals. 
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- /NOPRIV[=TTn:]. Sets the identified terminal to 


nonprivileged status. 


A nonprivileged user can only display the terminals 
that have nonprivileged status. A privileged user can 
set any terminal to nonprivileged status. 


The keyword omits =TTn:, the system displays all 
nonprivileged terminals. 


Examples: 


“SET /NOPRIY 
NOPRIV=ETT2: 
NOPRIV=TTS: 


Displays all nonprivileged terminals. 
“SET /NOPRIV=TTi: 
Sets the status of TTl: to nonprivileged. 


/PUB[=dev:]. (Multiuser protection systems only). The 
keyword establishes the specified device as a public 
device. When the keyword does not specify a device 
name, the command displays all the current public 
devices at the issuing terminal. SET /PUB is not a 
privileged form of the command. 


When the keyword specifies a device name, the command 
is privileged. In all cases, a user must be privileged 
to issue the SET /PUB=dev: form of the command. 


If the keyword omits =dev:, the system displays all 
public devices. 


Examples: 

“SET /PUB=LP: 
Establishes LPO: as a public device. 

“SET /PUB 

PUB=DBO: 

PUB=DBi: 

PUB=LPO: 
Displays all public devices. 
/NOPUB=[dev:]. (Multiuser protection systems. only). 
Causes the specified device to lose its public status. 
Nonprivileged users can only display the devices that 
previously were made public. Only privileged users can 
issue the SET /NOPUB=dev: command. 


When the keyword omits =dev:, the system displays at 
the issuing terminal all private and unowned devices. 
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Examples: 


+SET /NOPUB 
NOPUB=DKOs 
NOPUBSDK 1: 


Displays all private and unowned devices. 


SET /NOPUB=LPO: 
Removes the public status for LPO:. 


/REMOTE([(=TTn:] where TTn: is a terminal with a line to 
a DH11, DL11, or ODZ11l multiplexer. The keyword 
declares that the specified terminal is connected to a 
modem and can be connected by means of a dial-up 
network. 


A nonprivileged user can display all remote lines, but 
can only establish device TI: as a remote terminal. 
Privileged users can define any terminal as a _ remote 
line. 


When the keyword omits =TTn:, the system displays at 
the issuing terminal all remote lines (including DH11l 
lines). 


Examples: 


>SET /REMOTE 
REMOTE=TTis 
REMOTE=TT2: 
REMOTE=TT4: 


Displays all terminals that are currently set as remote 
dial-in lines. 


+SET /REMOTE=TT3: 


Sets the terminal line corresponding to MTT3: as a 
remote dial-in line. 


/NOREMOTE[=TTn:] where TTn: is a line to a D211 
multiplexer. The NOREMOTE keyword establishes the 
terminal's line as a local line not connected to a 
modem. 


A nonprivileged user can display all local lines, but 
can only establish device TI: as a local terminal. 
Privileged users can define any terminal as local. 


When the keyword omits =TTn:, the system displays at 


the issuing terminal all local lines (including DLI1, 
DH11, DJ1ll1, and DZ11 multiplexers). 
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Examples: 
“SET /NOREMOTE=TT3: 


Establishes the terminal line for TT3: as a local 
line. 


»SET /NOREMOTE 
NOREMOTE=TTOs 
NOREMOTE=TT3: 


Displays all local lines (including DL11, DH11l, DJll, 
and DZ11l multiplexers). 


/RPA[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /RPA keyword enables the 
read-pass-all option of the full duplex terminal 
driver. The terminal driver passes all input 
characters to the driver input buffer. 


A nonprivileged user can display all terminals that 
have the option enabled, but can only enable the RPA 
option for TI:. A privileged user can enable RPA _ for 
any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have the RPA 
option enabled. 


Examples: 


SET /RPA 
RPA=TTO: 
RPA=TT1l: 


Displays all terminals where input characters are 
passed directly to the full duplex terminal driver 
input buffer. 


»SET /RPA=TTS: 
Enables the RPA option for TT3:. 


/NORPA[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. The /NORPA keyword disables the 
read-pass~all option. The full duplex terminal driver 
does not pass special function input characters (such 
as Ge) from the terminal to the driver input 
buffer. 


A nonprivileged user can display all terminals’ that 
have the option disabled, but can only disable RPA for 
TI:. A privileged user can disable RPA for any 
terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that do not pass 
special function characters to the terminal driver 
input buffer. 
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Examples: 


>BET /NORPA 
NORPA=TT2: 
NORPA=TTa: 


Displays all terminals that have the RPA option 
disabled. 


SSET /NORPA=TT3:3 


Specifies that TT3: not pass special function input 
characters to the full duplex terminal driver input 
buffer. 


/SLAVE[=TTn:] where TTnn: is a terminal. Establishes 
the specified terminal as one that can enter data only 
if it is solicited from a task; thus, the specified 
terminal always rejects unsolicited input (other than 


Gia) , GR , and Gms) ). 


A nonprivileged user can display all slave terminals, 
but can only establish TI: aS a Slave terminal. 
Privileged users can establish any terminal as a_ slave 
terminal. 


Absence of TTn: results in the display of all 


terminals currently classified as slaves. 


Examples: 
“SET /SLAVESTT3: 


Establishes TT3: as a terminal that can only enter 
data solicited by a task. 


2SET /SLAVE 
SLAVE=TT3: 


Displays all slave terminals. 


/NOSLAVE[=TTn:]. Removes slave status from a specified 
terminal. 


A nonprivileged user can only display the non-slave 
terminals. A privileged user can set any slaved 
terminal to non-slave. 


Absence of =TTn: results in the display of all 
non-slave terminals. 
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Examples: 


*SET /NOSLAVE 
NOSLAYE=TTO: 
NOSLAYE=TT1: 
NOSLAVE=TT2: 
NOSLAVE=TT4: 


Displays all non-slaved terminals. 
“SET /NOSLAVESTT3: 
Sets TT3: to non-slave status. 


/SPEED=dev: {recv:xmit]. Establishes the receive and 
transmit baud rate for terminals attached to the system 
through a DH11 or DZ11 muitiplexer. The argument 
"recv" is the baud rate at which characters are input 
to the computer from the terminal; and "xmit" is the 
baud rate at which the computer outputs characters to 
the terminal. Both must be specified in setting the 
speed. If neither is specified, the current settings 
are displayed. 


A nonprivileged user can display the speed settings for 
any device, but can only set the speed of device TI:. 
A privileged user can set the speed of any terminal. 


Valid baud rates for the DH11 are: 0, 110, 150, 200, 
300, 600, 1200, 1800, 2400, 4800, 9600, 


Valid baud rates for the DZ1l are: 0, 110, 150, 300, 
600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, and 
9600. The receive and transmit baud rates for the D211 
must be the same; the DZ11 does not support split 
speeds. 


Examples: 


"SET /SPEED=TT3: 
SPEED=TT3:300:300 


Displays the current speed setting for TT3:. 
>SET /SPEED=TT3: 24002 2400 


Sets the receive and transmit baud rates for TT3: to 
2400. 


/TERM=TTnn: [value] where TTnn: is a terminal and value 
is a supported terminal type. The /TERM keyword 
establishes terminal type for a specified terminal. 
Supported standard terminal types are: 


ASR33 ASR35 KSR33 LA30P 
LA30S LA36 LA120 LA180S 
VTO5B VT50 VT52 VT55 
vTel VT100 
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A nonprivileged user can display the terminal type for 
any terminal, but can only establish terminal type for 
TI:. A privileged user can establish terminal type for 
any terminal. 


When the keyword omits the value parameter (terminal 
type), the system displays at the entering terminal the 
terminal type for the indicated terminal. 


MCR accepts an alternate form of the command; you 


specify the terminal type and equate it to the desired 
terminal. For example: 


SET /term-type=TTnn: 


where term-type is one of the above standard terminal 
types. 


Examples: 


*SET /TERMSTT3: 
TERM=TT3aVTS2 


Displays the terminal type for TT3: 
“SET /TERM=TT1sLA3G 

Establishes TTl: as an LA36 terminal. 
“SET /LAQG=TTLs 


Same effect as above example; establishes TTl: as an 
LA36 terminal. 


You can also use the alternate command forms to display 
all terminals that are not of a specific type. The 
format is as follows: 


SET /NOterm-type 


Note that you cannot negate a terminal type, you can 
only display the terminals not of a specific type; 
negating terminal type returns a syntax error, since 
the terminal would be of indeterminate type. 


/TYPEAHEAD[=TTnn:] where TTnn: is a terminal. Full 
duplex terminal driver only. This keyword instructs 
the full duplex terminal driver to buffer input 
characters before passing the characters to a 
requesting task. Thus, characters input between 
requests are not lost. 


A nonprivileged user can display all terminals that 
have the typeahead option enabled, but can only enable 
the option for TI:. A privileged user can enable 
typeahead for any terminal. 


When the keyword omits =TTnn:, the system displays at 


the entering terminal all terminals that have typeahead 
enabled. 
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Examples: 


xSET /TYPEAHEAD 
TYPEAHEAD=TT1: 
TYPEAHEAD=TT2: 


Displays all terminals for which the terminal driver 
buffers input characters before passing them to a task. 


sSET /TYPEAHEAD=TT3: 
Enables the typeahead option for TT3:. 


/NOTYPEAHEAD[=TTnn:] where TTnn: is a terminal. Full 
duplex terminal driver only. This keyword disables the 
typeahead option; the full duplex terminal driver does 
not buffer input characters to prevent their loss. 


A nonprivileged user can display all terminals that 
have the option disabled, but can only disable the 
eption for TI:. A privileged user can disable 
typeahead for any terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have typeahead 
disabled. 


Examples: 


*SET /NOTYPEAHEAD 
NOTYPEAHEAD=TTO: 
NOTYPEAHEAD=TT4: 


Displays all terminals that have typeahead disabled. 


“GET /NOTYPEAHEAD=TT3: 
Disables the typeahead option for TT3:. 


/UIC(=uic[:dev:]]. The specified UIC is established as 
the default UIC for the entering terminal unless dev: 
is specified, in which case the default UIC is set for 
that terminal. If the system supports multiuser 
protection, and the user is privileged, the command 
also sets the terminal's protection UIC. (See Section 
3.2.1.) All tasks run from the terminal are run with 
the UIC of the terminal, except in a multiuser 
protection system. In such a system, a privileged user 
can override the terminal UIC with the UIC switch in 
the Run command. Further, external MCR function tasksl 
are requested with this UIC. 


If a UIC is not specified, the current UIC is 
displayed. If only dev: is specified, the UIC for the 
specified terminal is displayed, provided that the 
terminal issuing the command is privileged. 


1 hese tasks are the MCR Mount, Install, Dismount, and UFD commands 
(which run as tasks) and all system-supplied software. 
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Examples: 


“SET /UIC 
UIC=CiO+10] . 


Displays the current default UIC for terminal TI:. 
SET /UIC#L303+31 
Sets the default UIC for terminal TI: to [303,3]. 


/VFILL[=TTnn:] where TTnn: is a terminal. Full duplex 
terminal driver only. This keyword enables_ the 
vertical fill characters option for the specified 
terminal. The option instructs the full duplex 
terminal driver to add four fill characters following 
each linefeed. 


A nonprivileged user can display all terminals that 
have the option enabled, but can only enable it for 
TI:. A privileged user can enable VFILL for any 
terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have VFILL 
enabled. 


Examples: 


“SET /VFILL 
VFILLeTTOs 
VFILLeTT1s 


Displays all terminals that have the VFILL option 
enabled. 


*SET /YFILLSTT3: 


Instructs the full duplex terminal driver to add four 
fill characters following each linefeed at TT3:. 


/NOVFILL[=TTnn:] where TTnn: is a terminal. Full 
duplex terminal driver only. This keyword disables the 
vertical fill option. 


A nonprivileged user can display all terminals’ that 
have the option disabled, but can only disable it for 
TI:. A privileged user can disable the VFILL option 
for any terminal. 


When the keyword omits =TTnn:, the system displays at 


the entering terminal all terminals that have the VFILL 
option disabled. 
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Examples: 


»SET /NOYVFILL 
NOWFILLSETT2: 
NOVFILL=TT4s 


Displays all terminals that have the VFILL option 
disabled. 


»GET /NOVFILL=TT3: 
Disables the VFILL option for TT3:. 


/WCHK [=dev:]. Specifies for all Files-1l devices 
except DX:, DL: and magnetic tape (MT:, MM:, MS:) that 
all writes are to be followed by a write check. This 
feature provides high reliability for data transfers to 
the specified disk. 


A nonprivileged user can only display the Files-1l disk 
drives with write check enabled. A privileged user can 
enable write checking for any device that supports it. 


If the keyword omits =dev:, all Files-11 disk drives 
with write check enabled are displayed. 


Examples: 
>SET /WCHK 
WCOHK=DBOQs 
WCHK= DAKO: 


Displays all Files-1ll disk drives that have write check 
enabled. 


“SET /WCHK=DK1: 
Enables write check on DK1:. 


/NOWCHK [=dev:]. Specifies that write check is to be 
disabled for the specified device. 


A nonprivileged user can only display the Files-11l disk 
drives that have write check disabled. A privileged 
user can disable write check on any device. 


If the keyword omits =dev:, all Files-1l devices except 
DX: and DLs: and magnetic tape (MT:, MM:, MS:) that 
have write check disabled are displayed. 


Examples: 


>SET /NOWCHK 
NOWCHK=DB1i: 


Displays all the devices that support write check, but 
have it disabled. 
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“SET /NOWCHK=DK1: 
Disables write check for DKl:. 


/WRAP[=TTnn:] where Tfnn: is a terminal. Full duplex 
terminal driver only. This keyword enables the wrap 
around option. The wrap around option instructs the 
full duplex terminal driver to generate a carriage 
return/linefeed sequence when the number of input 
characters exceeds the terminal's buffer size. The 
carriage return/linefeed sequence is transparent and 
does not appear in the input buffer. 


A nonprivileged user can display all terminals that 
have the option enabled, but can only enable it for 
TI:. A privileged user can enable wrap around for any 
terminal. 


When the keyword omits =TTnn:, the system displays at 
the entering terminal all terminals that have the wrap 
around option enabled. 


Examples: 


“SET /WRAP 
WRAP=TT1: 
WRAP=TT2: 


Displays all terminals for which a carriage 
return/linefeed sequence is generated following an 
input string that exceeds the terminal's buffer size, 


“SET /WRAP=TT3: 
Enables the wrap around option for TT3:. 


/NOWRAP[=TTnn:] where TTnn: is a terminal. Full 
duplex terminal driver only. This keyword disables the 
wrap around option; the full duplex terminal driver 
does not accept input characters beyond the buffer size 
for the terminal. 


A nonprivileged user can display all terminals that 
have the option disabled, but can only disable it for 
TI:. A privileged user can disable the option for any 
terminal. 


When the keyword omits =TTnn:, the system displays at 


the entering terminal all terminals that have the 
option disabled. 
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Examples: 
>SET /NOWRAP 
NOWRAP=TTO: 
NOWRAP=TT4: 
Displays all terminals that have the option disabled. 


+SET /NOWRAP=TT3: 


Disables the wrap around option for TT3:. 


Enable or Disable Logon Keywords: (Privileged option) 


LOGON = 


NOLOGON - 


/LOGON. Enables logging onto terminals in a multiuser 
protection system. The keyword is privileged. 


/NOLOGON. Disables logging onto terminals in a 
multiuser protection system. The keyword is 
privileged. /LOGON and /NOLOGON clear and set a flag 
checked by the Hello command when a user attempts to 
log onto a terminal. This Set option provides a means 
of preventing users’ from accessing the system during 
system maintenance or account file maintenance 
activity, for example. 


I/O Packet Keyword: 


MAXPKT - 


/MAXPKT[=n]. The /MAXPKT keyword specifies the maximum 
number of I/0 packets to be retained in a separate 
queue for use by the QI0 directive. The number of 
retained packets (n) is used to optimize the servicing 
of QIO requests. 


A nonprivileged user can only display the maximum and 
current number of available I/O packets. 


If the keyword omits n, the system displays at the 

issuing terminal the maximum number and the current 

number of available I/O packets in the format: 
MAXPKT=m.:C. 


where m. is the maximum number of and oc. is the 
current number of available 1/0 packets. 


Examples: 
“GET /MAKPKT=12. 


Sets the maximum number of I/0 packets retained for 
optimization of I/0 servicing to 12(10). 


3SET /MAXPRT 
MAXPKT=12.:3+% 


The maximum number of I/0 packets to be retained 


explicitly for QIO processing is 12(10). Three packets 
are currently available. 
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System or Library UIC Keywords: 


SYSUIC 


- /SYSUIC[(=uic] where uic has the format [g,m]; g and m 


are octal numbers that represent a group and member 
number respectively. The /SYSUIC keyword establishes 
the UIC for the system and all system tasks. On most 
unmapped systems, the system UIC is [1,50]; on most 
mapped systems, the system UIC is [1,54]. These UIC 
values are the initial defaults on virgin systems. 
This UIC becomes the default UIC used by the Load 
command and the install-run-remove option of the Run 
command. 


A nonprivileged user can only display the system UIC. 


When the keyword omits =uic, the system displays at the 
issuing terminal the current system UIC. 


Examples: 


“SET /SYSUIC 
SYSUIC=C1,34) 


Displays the current system UIC. 


“SET /SYSUICS(3+54] 


Sets the system UIC to [3,54]. 
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Memory Allocation Keywords: 


/MAIN=pname [:base:size:type] (Privileged RSX-11M keyword) 


/NOMAIN=pname (Privileged RSX-11M keyword) 
/SUB=mname: pname [:base:size] (RSX-11M keyword) 
/NOSUB=mname:pname (RSX-11M keyword) 


/PAR=pname [:base:size[:type]] (RSX-11M-PLUS keyword) 


/NOPAR=pname (RSX-11M-PLUS keyword) 


/POOL[=top] 


/MAXEXT [=size] 


Keyword Definitions: 


MAIN = 


/MAIN=pname [:base:size:type]. An RSX-11M keyword. 
Establishes a main partition. A nonprivileged user can 
only display the base, size, and type of a main 
partition. 


pname - The l- to 6-character alphanumeric partition 
name. 
z:base - Physical base address of the partition 


specified as a number of 64-byte blocks. 


ssize - Size of the partition specified as a number 
of 64-byte blocks. 
stype - TASK for a user-controlled task partition 


SYS for a system-controlled task partition 
COM for a common partition 


DEV for a common partition mapping into the 
device registers 


User-controlled and system-controlled task 


partitions contain user tasks. Common 
partitions are used for resident libraries 
and common blocks. Device partitions are 


used by nonprivileged tasks to access device 
registers in the external page, such as those 
for the UDC and ICS/ICR-11. 
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Base and size may be entered in any of the following 
formats; nnnn is a number (in bytes) to which a 
multiplication factor is applied to determine the value 
used, 


Format Calculated Value 
nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnk Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


Valid ranges of calculated values (in words) are: 


Octal 0<=base<177777 O0<size<2000 
Decimal 0.<=base<65535 0.<size<1024. 
Octal K OK<=base<3777K OK<size<40K 
Decimal K 0.K<=base<2047.K 0.K<size<32.K 


For system-controlled partitions, size May range 
from 0 to 1920.K or any valid representation of 
these limits. 


For example, any of the following inputs for size 
will allocate a 1920. - byte partition. 


If the command does not specify base, size, and type, 
MCR displays the values of these parameters for the 
named partition. If the named partition is a task 


_pPartition, MCR also displays the parameters of all its 


subpartitions. 
Examples: 
*SET /MAIN=SYSPAR!420:140:TASK 


Defines a main partition named SYSPAR as a 
user-controlled partition whose base address is 
42000(8) and whose length is 14000(8) bytes. 


“SET /MAIN=SYSPAR 
MAIN=SYSPAR:0420:0140:TASK 


Displays the parameters of the main partition SYSPAR. 
Note that if the main partition is a task partition and 
contains subpartitions, the parameters of the 
subpartition are also displayed. 


/NOMAIN=pname. A privileged, RSX-11M keyword. 


Eliminates the named partition or library from the 
system. 
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SUB 


Example: 

+SET /NOMAIN=SYSPAR 
Eliminates the main partition SYSPAR from the system. 
/SUB=mname [:sname: base:size]. An RSX-11M keyword. 


Establishes a subpartition. Subpartitions may only be 
established in user-controlled main partitions. 


mMname - The l- to 6-character main partition 
name. The subpartition being defined 
becomes a subpartition in the named main 
partition. 

:sname - The l- to 6-character subpartition name. 


The subpartition being defined becomes a 
subpartition of the main partition 
specified in mname. 


sbase - Physical base address of the 
subpartition, specified as a number of 
64-byte blocks. 


:size - Size of the subpartition, specified as a 
number of 64-byte blocks. 


Base and size may be entered in any of the following 
formats; nnnn is a number (in bytes) to which a 
multiplication factor is applied to determine the value 
used. 


Format Calculated Value 
nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnk Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


Valid ranges of values (in words) are: 


Octal 0<=base<10000 0<size<2000 
Decimal 0.<=base<4096. 0.<size<1024. 
Octal K O0K<=base<200K OK<size<40K 
Decimal K 0.K<=base<2047.K 0O.K<size<32.K 


For example, any of the following inputs for 
size will allocate a 2048. - byte partition. 


40 
32. 
1K 
1.K 


If base and size are omitted, the current values will 
be displayed for the named subpartition. 
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Examples: 

“SET /SUB=SYSPAR:MCRPAR:445:56 
Defines a subpartition named MCRPAR in the main 
partition SYSPAR whose base address is 44500(8) and 
whose length is 5600(8) bytes. 
/NOSUB=mname: sname. A privileged, RSX-11M keyword. 
Eliminates the named subpartition (sname) from the 
specified main partition (mname). Example: 


“SET /NOSUB=SYSPAR:MCRPAR 


Eliminates the subpartition MCRPAR from the main 
partition SYSPAR 
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SE, 
POOL - /POOL[=top]. Increases the size of the dynamic storage 
region. 
top - Specifies the first location in memory to be 
used for user partitions. Specify the 
location in units of 64-byte blocks. It can 
be given in octal or decimal. 
a, 
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The format is: 
POOL = top:max:total 


where top is given in units of 64-byte blocks. max and 
total are in decimal words. 


A nonprivileged user can only display the size of the 
dynamic storage region, 


If the keyword omits =top, the system displays the size 
of the dynamic storage region in the format: 


POOL=floc:1lfb:tps 
where: 


floc is the first location for user partitions 
(displayed in octal bytes with two trailing zeroes 
suppressed). 


lfb is the longest free block (displayed in decimal 
words). 


tps is the total pool space (displayed in decimal 
words). 


Examples: 
“SET /POOL=420 


Establishes 42000(8) as the beginning for user 
partitions. 


“SET /POOL 
POOL=04202150,.:430, 


Displays the first location for user partitions, the 
longest free block, and the total of all pool space 
(the first free block is at 42000, the longest free 
block is 150. words, and the total of all pool space 
is 430. words. 


/MAXEXT[=size]. Establishes the maximum size to which 
a task can extend itself by means of the Extend Task 
directive (see the RSX-11M/M-PLUS Executive Reference 
Manual). The keyword is privileged and is only valid 
on mapped systems that choose to support the Extend 
Task directive at system generation. The maximum size 
can be expressed in four formats: 


n 
nK 
n. 
n.K 


See the description of /MAIN or /SUB for a definition 
of these size values. 
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Notes: 


If the keyword omits =size, the system displays at the 
issuing terminal the current maximum size in the 
format: 


MAXEXT=m 


where m is an octal number equal to the maximum size 
allowed for a task, in 64-byte blocks (for example, 
1200 indicates 20K words). A nonprivileged user can 
only display the maximum size to which a task can 
extend itself. 


Examples: 
SET /MAXEXT=20K 


Establishes 20K as the maximum size to which a task can 
extend itself. 


*SET /MAXEX 
MAXEXT= 1200 


Displays the current maximum size that a task can 
extend itself. 


If a partition currently contains a task, and a keyword (for 
example, /NOMAIN or /NOSUB) attempts to eliminate the 
partition, the system rejects the command. 


A keyword that eliminates a main partition also eliminates all 
its subpartitions. A keyword that eliminates a specified 
subpartition eliminates only that specified subpartition. 


If a keyword attempts to eliminate a main partition that has 
subpartitions in which tasks are installed, the system rejects 
the keyword until those tasks are removed from the 
subpartitions. 


When defining a partition (main or sub) the name must not 
already be defined as a partition. In addition, a main 
partition cannot overlap any other main partition; nor can a 
Ssubpartition of a main partition overlap any other 
subpartition of the main partition. An exception is for 
Device partitions, which can overlap. 


The numeric value convention applies to all the Set command 
numeric values. 


All partitions except the resident loader partition, . LDR., 
are considered user partitions by the POOL command. Thus, for 
example, SYSPAR is considered a user partition. 


Once you allocate space to the dynamic storage region, the 
space can never be recovered for use in partitions. 
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ontrolled partitions cannot include subpartitions 
ly defined by the Set command. An attempt to define 
tions of system-controlled partitions in this way will 
cted. The Executive dynamically defines subpartitions 
tem-controlled partition as needed for tasks installed 
ystem-controlled partition. 


ask Keywords: 


TTnn: 
= dev: [uic]filename.typ 
TTnn: dev: (uic]filename.typ 
OG 
M[=TTnn:] 
LE[=dev: [uic]filename.typ] 


or RSX-11M-PLUS SYSTEM Generation and Management Guide 
ion of the Console Output Task (COT). All of the COT 
vileged. If COT is not active, the keywords initiate 
using default or user-supplied console terminal and 
cifications. The /COLOG keywords provide a means. to 
console terminal and the listing file specifications. 
/LOGFILE keywords change a single specification. 


ons: 


/COLOG. If the console output task is active, the 
keyword displays the name of the listing file and the 
terminal number for the console terminal. If cCoT is 
not active, the keyword initiates console logging 
using TTO: as the default console terminal and the 
file Sy:[1,4] CONSOLE.LOG as the default listing file. 


Example: 


“SET /COLOG 
CONSOLE = TT: 
LOGFILE = SYOrCi+4ICONSOLE,LOG#1G 


Displays the default console terminal and the name of 
the listing file. 


/COLOG=TTnn:. If COT is active, the keyword closes 
the current listing file, opens the next version as 
the new listing file, and uses the specified terminal 
as the console terminal. If COT is not active, the 
keyword initiates console logging using the specified 
terminal as the console terminal and the file 
S¥:[1,4]CONSOLE.LOG as the default listing file. 


Example: 
*SET /COLOGSTT3:s 


Creates a new version of the listing file and uses 
TT3: as the console terminal. 
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- /COLOG=dev: [UIC]filename.typ. If COT is active, the 


keyword closes the listing file and opens’ the 
specified file for use as the listing file. Note that 
TTO: becomes the default console terminal; if you 
wish to change only the listing file, use the /LOGFILE 
keyword. If COT is not active, the keyword initiates 
console logging using the specified file as _ the 
listing file and TTO: as the console terminal. 


Example: 


~SET /COLOG=DB1:C1+41]TEMP.LOG 


Closes the current listing file and opens the file 
DB1:[1,4]TEMP.LOG. The console terminal becomes TTO:. 


/COLOG=TTnn: dev: (UIC]filename.typ. If COT is active, 
the keyword closes the listing file, opens’ the 
specified file for use as the listing file, and uses 
the specified terminal as the console terminal. If 
COT is not active, the keyword initiates console 
logging using the specified terminal and listing file. 


Example: 


»SET /COLOG=TT2:DB:C3,+GINEW,LOG 


Closes the current listing file and uses TT2: as_ the 
console terminal and the file DB:[3,6]NEW.LOG as the 
listing file. 


/NOCOLOG. This keyword instructs COT to close the 
current listing file, redirect CO: to TTO:, and exit. 


/COTERM[=TTnn:]. If cCoT is active, the keyword 
redirects console terminal messages to either TTO: 
(the default console terminal) or to the specified 


terminal. Note that the keyword does not close or 
increment the version number of the current listing 
file. If COT is not active, the keyword initiates 


console logging using TTO: or the specified terminal 
as the console terminal. Note that the keyword 
initiates COT without a listing file. 


When the keyword omits =TTnn:, console terminal 
messages are printed on TTO:. 


Example: 
-SET /COTERM=TTG: 
Redirects console terminal messages to TT6:. If cot 


waS not active when the command was issued, console 
terminal messages are not written to a listing file. 
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NOCOTERM - /NOCOTERM. This keyword inhibits the printing of 
messages on the console (or the redirected console) 
terminal. Console terminal messages are recorded in 
the listing file. The keyword is valid only if COT is 
active. 


Example: 
*SET /NOCOTERM 


Inhibits printing of messages on the console terminal. 


NOTE 


If the first character of a console 
terminal message isa and there 
is no assignéd console terminal, the 
message is printed on TTO:. If there is 
an assigned console terminal, the 
message is printed on the appropriate 
console terminal. 


LOGFILE - /LOGFILE[=dev: [uic]filename.typ. If COT is active, 
this keyword closes the current listing file and 
either increments the version of the current file (if 
you omit the file specification) or creates a new 
listing file using the specified file. If COT is not 
active, the keyword initiates console logging using 
SY:[1,4]CONSOLE.LOG or the specified file as the 
listing file. Note that the keyword initiates COT 
without a console terminal; console terminal messages 
are written in the listing file only. 


When the keyword omits a fjle specification, console 
terminal messages are written in SY:[{1,4]CONSOLE.LOG. 


Example: 
?SET /LOGFILE 
Closes the current listing file and then uses the next 
highest version of SY:[{1,4]CONSOLE.LOG as the listing 
file. If COT was not active when the command was 
issued, console terminal messages are not printed on 
the console terminal. 
Command Error Messages: 
SET -- ALIGNMENT ERROR 
An attempt was made to create a partition, but’ the 


base address or size conflicted with existing 
partitions or physical memory size. 
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SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


DEVICE NOT VARIABLE SPEED MULTIPLEXER 
An attempt was made to set the baud rate for a 
terminal that was not attached to a DH11 or DZ1l 
multiplexer. 

DEVICE NOT TERMINAL 


An attempt was made to set terminal characteristics 
for a nonterminal device. 


FEATURE NOT SUPPORTED 
The command keyword specifies an optional feature that 
was not incorporated into the system at system 
generation. 

INVALID SPEED 
The multiplexer line specified does not support the 
requested speed; or the command specified unequal 
receive and transmit speeds for a DZ11. The DZ1l1 does 
not support split speeds. 

LINE NOT D211 


The command attempted to set to remote a line that was 
not attached to a DZ11 multiplexer. 


NON EXISTENT MEMORY 


An attempt was made to define a partition in 
nonexistent memory. 


OVERLAP SEEKS NOT SUPPORTED 
The command attempted to enable overlapped seek 
Support for other than a DM, DP, or RH device 
controller. 


PARTITION ALREADY EXISTS 


An attempt was made to define a partition with a name 
already in use. 


PSEUDO DEVICE ERROR 


The command attempted to make a pseudo device public. 
Pseudo devices cannot be public devices. 


SPACE USED 


An attempt was made to create a partition or 
subpartition in a Storage area already occupied. 


TASK INSTALLED IN PARTITION 


An attempt was made to eliminate a main partition or 
subpartition containing installed tasks. 
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TOO MANY SUBPARTITIONS 


An attempt was made to define more than seven 
subpartitions. A main partition is limited toa 
maximum of seven subpartitions. 


UNKNOWN MAIN PARTITION 


An attempt was made to define a sSubpartition of a 
nonexistent main partition. 


USER PARTITION >32K NOT PERMITTED 


The command attempted to create a partition greater 
than 32K. User-controlled partitions greater than 32K 
cannot be created in systems that do not - support 
extended logical address space, a system generation 
option. 


WRITE CHECK NOT SUPPORTED 


An attempt was made to enable write check on a device 
that was not a DB:, DF:, DK:, DM:, DP:, DR:, or DS:. 
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STOP 


The Stop command declares that a specified task is no longer eligible 
to execute or compete for memory. Nonprivileged users can only stop a 
task requested from the issuing terminal. A privileged user can stop 
any task. 


Stopping a task sets the stop bit in the Task Control Block (TCB). 
When a task's stop bit is set, the system considers the task blocked 
as well as ineligible to compete for system resources. To clear’ the 
stop bit, issue the Unstop command. 
Format: 

STP [taskname] [/TERM=TTnnn: ] 
where: 

taskname is the name of the task to be stopped. If you 


omit taskname, the command stops the task 
requested from the issuing rminal 


Examples: 
RSX-11M systems 


:STP BOBTI7 


Stops task BOBT17 and removes it from competition for 
memory. 


RSX-11M-PLUS system: 


“STP BOB/TERM=TT1iO0: 


Stops task BOBTAO and removes it from competition for 
Memory. 
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TASK LIST ~ ATL FORMAT 


This command displays on the entering terminal the names and status of 
all tasks or of a specific task installed in the system. The display 


format is the same as that of the Active Task List (ATL) command. 
the ATL command for a description of the printout. 


Format: 
TAL [taskname] 


where taskname is the name of a specific task. 


Example: 
>TAL 
» LOR. O82220 LOR O52164 oog0oKNoo-GOddd0Ga PRI - 248. DPRI ~ 248, 


STATUS: ~CHK FXD STP PRY 
TI - COO: TOC - 0. EFLG - O00001 O00 900 PS - 170000 PC - 041350 
REGS O-G O00162 O04030 177777 105312 064254 105260 O32102 

TKTN 105010 SYSPAR 107734 90110000-00120000 PRI - 248, DPRI ~ 248. 
STATUS: -EXE OUT -CHK -PMD PRY 
TI ~ COO: gc - Oo, EFLG - ooooo1 OO0000 

RMDEMO OS5S6214 GEN O53740 OOFI7TSO0-00233300 PRI - 225. DPRI - 225, 
STATUS: WFR PRY CAL 
TI = TTO:s IOC - O, EFLG - OO0001 OOOOOO PS - 170010 PC ~ Leso7e2 
REGS 0-6 1239593 000070 OOOOOO 125092 001601 191530 1203952 

PIPT2 oOG1454 GEN O71524 002774300-0039353900 PRI - 50, DPRI - 30. 
STATUS: OUT CKP TIO STP WFR -PMD REM MCR 
TI ~ Th: Toc - GO, EFLG - o00003 O40000 


"TAL RMDEMO 

RMDEMQO O86214 GEN O53740 OO217800-00233300 PRI - 225. ODPRI - 225. 
STATUS: WFR PRY CAL 
TI - TTOs tac - 1. EFLG - 00000 o00000 PS - 170010 PC - 1390224 
REGS O-G GOOO50 000132 OOOOOO 1250392 OO1GO1l 131530 120350 


ae 
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The Task List command displays on the entering terminal a description 
of each installed task. The display contains: 


1. Task name 

2. Task version identification 

3. Partition name 

4. Task priority 

5. Size of task in bytes (octal) 

6. Load device identification 

7. Disk address logical block number (octal) 


8. Task memory state 


Format: 
TAS[KLIST] 

Example: 
*TAS 
+e+lLDR 07,05 LDRPAR 248, 90002200 LBO:-01095303 FIXED 
TKTN 03.3 SYSPAR 248. 00010000 LBO:-01126742 
RMDEMQ X03.03 GEN 225, 00013700 SYO:-O0952100 
MTAACP 9006 GEN 200, OOO13000 DSO:-00000777 
F1iMSG Yoo1O GEN 200, OOOO8400 SYO:-O1053030 
MCRe+. 342 SYSPAR 16090, 00010000 LBO:-01051626 
DCL... O119A SYSPAR 160, 00010000 LBO:-00567017 CHECKPOINTED 
+++ DCL O113A GEN 160, 90040000 LBO:-01221102 
TAST1I7 O1 GEN 1660, 90025000 LBO:-01051676 
+++STO O00OOS SYSPAR i511, O0O010000 SYO:-d11365d0 
+++BYE 01,55 GEN 150, 000490000 LBO:-01051337 
FilACP MO235 FCPPAR 149, 00040000 LBO:-010524d45 
SECFCP M0235 GEN 149, 00026200 SY¥O:-O00055463 
DTAACP MO2Z35 GEN 149, 00026200 SYO:-O1052554 
++4+DMO 03,2 GEN 140, 90040000 LBO:-01051403 
e+e INI O34 GEN 140, O0040000 LBO:-01051561 
+o+MOU 03,01 GEN 140, 00040000 LBOs-01051653 
+o +UFD YOdO7 GEN 140, O09040000 LBO:-010 


(operator typed to suppress further output) 


The display contains, in columnar form, from left to right: task 
name, task version identification, partition name, task priority, 
task size, load device identification, logical block number on 
the load device, and task memory state. On a processor with less 
than 124K words of memory, the size field (fifth column) contains 
6-digit rather than 8-digit numbers. 


FIXED indicates that the task is fixed in memory. 


CHECKPOINTED indicates that the task has been swapped out of 
memory to make room for a higher priority task. 
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If the task version identification is missing (the rest of the 
line is offset to the left) or garbage, the task was installed 
from a disk that has since been removed from the drive or 
replaced by another cartridge. 
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TIME 
The Time command makes it possible to: 
° Set the current time of day (privileged) 
e Set the current date (privileged) 
e Display the current time and date 
Format: 
TIM[E] thesentaereseesTi [ml/day/year] 
or 
TIM[E] [(hrs:mins[:secs]] [day-m2-year] 
where: 
hrs - Hours (range 0-23) 
mins - Minutes (range 0-59) 
secs - Seconds (range 0-59) (optional) 
ml - Numeric representation of month (range 1-12) 
m2 - 3-letter abbreviation for month 
day - Day (range 1-31) 
year - Year (range 0-99). Year is relative to 1900; thus, 
1979 is entered as 79. 
Notes: 
e If the command specifies neither time nor date, the system 
displays the current time and date on the entering terminal. 
e If a privileged user specifies the time and date, the command 
sets the clock and calendar. If only the time is specified, 
only the clock is set; if only the date is specified, only 
the calendar is set. 
° A privileged user can specify the time and date in either 
order. 
e All numeric values are decimal. No terminating period is 
necessary (or permitted). 
Examples: 


>TIM 


LO:;23:31 O3-NOU-78 


>TIM 


Displays the current time and date. 
Le30 11/7/78 


Sets the time to 01:30:00 and the date to 07-NOV-78 
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USER FILE DIRECTORY 


This command creates a User File Directory (UFD) on a Files-1l volume 
and enters its name into the Master File Directory .(MFD). See Section 
3.1.1 for further information about UFDs. Before defining a UFD in an 
RSX-11M system, you must first initialize and mount (INI and MOU) the 
volume. You can add UFDs at any time after initializing and mounting 
a volume. Before defining a UFD in an RSX-11M-PLUS system, you must 
first mount the volume (if the volume has not been initialized, mount 
the volume as foreign) and, if necessary, initialize it. You can add 
UFDs at any time after mounting a volume. 


In multiuser protection systems, a nonprivileged user can create a UFD 
only on a volume mounted on the user's private device (that is, a 
device that the user has allocated). Otherwise the user must issue 
the command from a privileged terminal. 
Format: 
UFD ddn: [volume-label] [group, member] [/keyword] [/keyword] 
Keywords: 


/ALLOC=number~of-entries 


/PRO= [system, owner, group,world] 


where: 
ddan: - Device-unit containing the volume on which 
the UFD being created will reside. 
Default: none; must be specified. 
volume-label - If specified, the label is compared with 


the label on the volume. If the names 
match, a UFD can be allocated. If they do 
not match, the command is rejected. 
Default: nulls; no check is made. 
{group,member] - The UIC for the UFD. The UIC’ establishes 
the owner of the UFD. The square brackets 
are required syntax. 
Default: none; must be specified. 
ALLOC - Number of directory entries for which space 
is to be allocated. The number provided is 
rounded up to the next multiple of 32(10). 


Default: 32(10) 
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PRO - Establishes access rights for the directory 
file. Access codes consist of four 4-code 
groups in the Access Rights word, as 
follows: 

R - Read 
W - Write 
E - Extend 
D - Delete 


In each instance, the absence of the code 
means that the user class is denied the 
access right. 
Defaults: [RWED,RWED,RWED,R] 
Example: 
SUFD DKi:Ci+i] 
Create a user file directory (UFD) for the UIC [1,1] on 
DK1l:. The name and file number of the UFD file are entered 
into the MFD. The name of the UFD is 001001.DIR;1, and its 
owner is UIC [1,1]. 
Command Error Messages: 
UFD -- CAN'T READ MCR COMMAND BUFFER 


The UFD was initiated by a Run command rather than as 
an MCR command. 


UFD -- DIRECTORY ALREADY EXISTS 


The requested UFD already existed on the volume. 


UFD -- FAILED TO CREATE DIRECTORY 
No space existed on the volume, or an I/O error 
occurred. 

UFD -- FAILED TO ENTER IN MFD 


There was no room in the MFD or on the volume, or an 
I/O error occurred on the volume. 


UFD -- HOME BLOCK I/O ERROR 
An error was detected in reading the volume home 
block. 

UFD -- NOT FILES-11 DEVICE 


The device on which the UFD was to be created was not 
a Files-1ll device, and therefore could not support 
UFDs. 
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UFD ~- VOLUME NOT MOUNTED 


The volume on which a UFD is to be created 
mounted before accessing the Files-1ll struct 


UFD -- WRITE ATTRIBUTES FAILURE 


An error waS encountered while writing the 
of either the MFD or the newly created UFD. 


UFD -- WRONG VOLUME 


must be 
ure. 


attributes 


The volume label and the label specified in the 


command did not match. 
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UNSTOP 
The Unstop command continues execution of a previously stopped task. 
A nonprivileged user can issue the Unstop command only for tasks 
initiated from the entering terminal. A privileged user can direct 
the Unstop command to any stopped task. 
Format: 
UNS[TOP] [taskname] [/TERM=TTnnn: ] 
where: 
taskname is the name of the task. If you omit taskname, 


the command allows the task requested from the 
issuing terminal (task TTnn) to continue. 


a privi leged RSX-1 
p bit. for. 
terminal. | 
Examples: 
RSX-11M system: 

“UNS BOBT17 


Clears the stop bit for task BOBT17 and allows it to continue 
executing. 


RSX-11M-PLUS systems 
“UNS BOB/TERM=TT191: 


Clears the stop bit for task BOBTD1 and allows it to continue 
executing. 
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ACS 


ALLOCATE CHECKPOINT SPACE 


The Allocate Checkpoint Space (ACS) command allocates or discontinues 
a checkpoint file on disk for systems that support the dynamic 
allocation of checkpoint space. The disk containing the checkpoint 
file must be in Files-11 format. Only one checkpoint file per disk is 
allowed; but numerous disks can each contain a checkpoint file. In 
general, sufficient checkpoint space is twice the total amount of 
memory that all of the running tasks are using. 


When looking for file space to checkpoint a task, the system initially 
searches the first checkpoint file to be created. If space is not 
available in the primary file, it searches the second file to be 
created, and so on. The order in which checkpoint files were created 
determines the order in which the system scans the files when 
searching for available checkpoint space. 


An ACS command that discontinues a checkpoint file may not take effect 


immediately. If the specified file contains one or more checkpointed 
tasks, the tasks must be returned to memory before the system can 
discontinue the file. However, once the request to discontinue the 


file has been made, the system does not use the file for any more 
checkpointed tasks. 


Format: 


ACS ddn: /BLKS=n 


where; 
ddn: - A device-unit that contains a mounted Files-1ll 
disk. If the unit number (n) is not specified, it 
defaults to 0. 
/BLKS - /BLKS=n. A keyword that specifies the number (n) 


of blocks on the disk to be allocated for the 
checkpoint file. (A block is 512(10) bytes long.) 
For example, the command 


,ACS DBs /BLKS=250, 


allocates 250(10) blocks for a checkpoint file on 
DB:. 


When n is 0, the system discontinues the use of 


the checkpoint file; the file is neither deleted 
nor truncated. For example, the command 


>ACS DB:/BLKS=0 


_discontinues the checkpoint file on disk DB:. 
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When n is 1, the system deallocates the space used 
for the checkpoint file. 


Examples: 


“ACS DS:/BLKS=250, 
ACS DB:/BLKS=1074, 


Allocate a primary and a secondary checkpoint file. The 
primary file on DS: (a fixed-head disk) is 250(10) blocks 
long. The secondary file on DB: is 1024(10) blocks long. 


7ACS DS: /BLKS=0 
Discontinue use of the checkpoint file on DS:. 
Command Error Messages: 
ACS -~ CHECKPOINT FILE ALREADY IN USE ON DEVICE 


A previous ACS command established a checkpoint file 
on the volume mounted on the specified device-unit. A 
volume can contain only one checkpoint file. 


ACS -- CHECKPOINT FILE NOW INACTIVE 


This message appears after you issue an ACS command to 
discontinue a checkpoint file and the file does not 
contain any checkpointed tasks. The message indicates 
that use of the file was discontinued immediately 
after the command was issued. If the file were still 
in use, TKTN would issue a message when the file was 
finally discontinued. 


ACS -- DYNAMIC ALLOCATION OF CHECKPOINT SPACE NOT SUPPORTED 


The ACS command was issued on a system that did not 
include support of dynamic allocation of checkpoint 
space at system generation. 


ACS -- FILE I/O ERROR nnn, 


The ACS command detected an error when it tried to 
allocate or open the checkpoint file. The code nnn. 
is an FCS error code that defines the cause of the 
error. See Appendix I of the IAS/RSX-11 I/0 
Operations Reference Manual. (If the code is -24, the 
message may Indicate that the disk, usually a 
fixed-head disk, does not have enough contiguous space 
to allocate ‘the file. The normal implication of the 
code -24 is device full.) 


ACS -- FILE NOT IN USE 


A checkpoint file was not in use on the device 
specified in the ACS command. 
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ACS -- NOT FILES-11 DEVICE 


**k ddnn: 


The command specified a device that did not contain a 
Files-1l1 disk. The specified device-unit must contain 
a mounted Files-1l1l disk. 


-- CHECKPOINT FILE NOW INACTIVE 


The message, issued by TKTN, indicates that a request 
to discontinue use of a checkpoint file on device 
ddnn: has finally been satisfied. The need to return 
checkpointed tasks from the discontinued file back 
into memory caused the delay between the request and 
this message. 
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ALTER 
The Alter command changes the static or running priority of an 
installed task. 
Format: 
ALT[ER] taskname /keyword 
Keywords: 

/PRI=running and static priority 

/RPRI=running priority only 

/7TERM=TTnnn: (RSX-11M-PLUS systems) 

where: 

taskname ~ The name of the task whose priority is to be 
altered. 

/PRI - Changes the task's static priority, and, if 
the system supports the Alter Priority 
directive, the task's running priority. 

/RPRI - Changes the task's running priority only 


(valid only in systems that support the Alter 
Priority directive). 


The priority is in the range 1 to 250 decimal. The 


that the priority you specify is octal unless you include 


(.). 
Examples: 


RSX-11M systems 


“ALT TEST /PRI=248, 


Alter the static and running priority 


248(10). 


7ALT CMFRUN /RPRI=70,. 


of 


system assumes 


task TEST 


Alter the running priority of task CMFRUN to 70 (10). 


RSX-11M-PLUS systems 


SALT ABC/PRI=202./TERM=TTB: 


Alter the static and running priority of 


202(10). 
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BOOT 

The Boot command bootstraps a system that exists as a task-image file 
on a Files-11 volume. It provides a convenient means of terminating 
one system and initiating another, especially on minimum hardware 
configurations. For example, Boot can be used to terminate a 
real-time system and initiate a program development system. 


The Boot command immediately terminates the system currently in 
operation. 


Bootable systems are special task image files that have no task 
headers. Examples of such systems are RSX-11M, RSX-11S, and PRESRV. 


Format: 
BOO[T] [(filespec] 
where: 


filespec - The standard RSX-11M/M-PLUS file specifier of the 
form 


dev: {g,m]filename.type;ver 


that specifies the file from which a new system 
is to be loaded. 


Defaults applied to the file specifier are: 


dev: - The system device LB: 

[g,m] - The uIC under which Boot is 
running 

filename - RSX11M 

type - sys 

version - Latest version 


Note that Boot is the only command that allows the file specifier to 
omit the file name field. 


Restrictions: 


- Virgin system Boot -- The boot device physical unit number (unit 
plug) must equal the logical unit number in the virgin system. 
Otherwise, the initial Save will not work. 


Under certain circumstances, it is not possible to boot a large, 
Mapped, virgin Executive from an unmapped system. If the new 
Executive has loadable drivers above 27.5K words, the drivers 
will not be read into memory, thus causing problems when you try 
to run the system. This can happen because Boot moves the 
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bootstrap code in an unmapped system to the top of memory less 
.5K. To an unmapped Boot, this location appears to be 28K. Boot 
then reads the virgin system image into memory starting at 
address zero up until the beginning of the bootstrap. On saved 
systems, Boot only reads the first block (512 bytes) of the saved 
system image and then passes control to the bootstrap code to 
read in the rest of the system. 


When a mapped system is used to boot a new system, Boot reads in 
the entire target system (minus .5K for the bootstrap), because 
the KT11 is enabled, allowing Boot to recognize more than 28K 
words of memory. 


If the Executive Debugging Tool (XDT) has been generated into the 
system, XDT displays the following prompt when an RSX-11M/M-PLUS 
system is booted for the first time: 


XDT> baselevel 
XDT> 


Where baselevel is BL26 for an RSX-11M system or BL6 for an 
RSX-11M-PLUS system. 


Typing the G key in response to the prompt returns control to 
RSX-11M/M-PLUS, and causes the system to come up normally. After the 
system has been saved, XDT does not reappear unless a user setS a 
breakpoint or issues the BRK command. (See the RSX-11M or 
RSX-l11M-PLUS Guide to Writing an I/O Driver for a description of XDT.) 


Example: 


*BOO TEST 


Bootstraps from the system device the system contained in 
the file TEST.SYS. 


Command Error Messages: 
BOO -- DPB ERROR 
A bad DPB was created by Boot. this error indicates 
that the system itself has faulted. If the error 
persists, submit a Software Performance Report (SPR) 
to DIGITAL. 
BOO -- FILE NOT CONTIGUOUS 


An attempt was made to load a system from a 
noncontiguous file. System images must be contiguous. 


BOO -- INVALID LOAD DEVICE 


Boot detected a device that was invalid as a _ system 
residence device. 
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BREAKPOINT TO EXECUTIVE DEBUGGING TOOL 


The BRK command passes control to the Executive Debugging Tool (XDT) 
if it has been generated into the system. If XDT is not in the 
system, the command has no effect. See the RSX-11M or RSX-11M-PLUS 
Guide to Writing an I/O Driver for a description of XDT. Note that, 
if successful, the command halts all system activity; proceeding from 
a breakpoint normally restores the system to the state that existed 
when the BRK command was issued. 


When XDT gains control, it prints the message 


BE: nnonnnn 
XDT> 


on TTO: to indicate that XDT now has control. All XDT commands are 
available for use in debugging the Executive or user-written drivers. 
To return control to MCR, enter the P command; MCR then prompts) with 
>. 


Format: 


BRK 
Example: 
7 BRK 


BE: 124560 
XDT>P 
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CLQUEUE 


The CLQUEUE command displays on the entering terminal information 
about tasks currently in the clock queue. The information consists of 
the task names, the next time each task is to be run, and each’ task's 
reschedule interval, if one was specified. The system places a task 
in the clock queue if the task was activated by a Run command or a 
RUNS directive that specified a time-based option. 


Format: 
CLQ [UEUE] 


Example: 
+ CLO 
TASK1 SCHEDULED AT 18-DEC-78 10:24:30:00 
TASK2 SCHEDULED AT 18-DEC-78 10:30:00:00 RESCHEDULE INTERVAL 30 MINS 


The first task in the queue will be run at 10:24:30:00 (hour: 
minute: second: clock tick); it has not been rescheduled. The 
second task in the queue will next be run at 10:30:00:00 and is 
scheduled to run every 30 minutes. 
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FIX-IN-MEMORY 


The Fix-in-Memory command loads and locks a task into its partition. 
Subsequent requests for running the task are serviced more quickly 
because the task is memory-resident and does not have to he loaded 
from the disk before it can run. The system can fix a task in memory 
only when the partition in which it is to be fixed becomes available. 


Fixed tasks remain physically in memory even after they exit. 
Therefore, they do not have to be reloaded when a request is made to 
run then. (Note that reexecuting fixed tasks is not always practical; 
to reexecute, the task must be serially reusable.) Only an Unfix or 
Remove command can free the occupied memory partition. 


The following restrictions apply to the fixing of tasks: 


e In RSX-11M systems, checkpointable tasks cannot be fixed. In 
RSX-11M-PLUS systems, checkpointable tasks should not _ be 
fixed; fixing a checkpointable task makes the task 


non-checkpointable. 
e Active tasks cannot be fixed. 
@e A task must be installed before it can be fixed. 
Format: 


FIX taskname 


where taskname is the name of the task to be fixed in memory. 


“FIX KKE 
Fix task XKE in its partition. 


oFIX FCSRES/REG 


Fix the resident library for FCS in its partition. 
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PPIX «.++MAC/RON 


Fix the read-only segment of the MACRO-11l assembler in its 
partition. 


Command Error Messages: 
FIX -- PARTITION BUSY 


The partition in which the task was to be fixed was 
occupied, so the task could not be fixed. 


FIX -- TASK ALREADY FIXED 

The specified task was already fixed in memory. 
FIX -- TASK BEING FIXED 

The subject task was already being fixed. 


FIX -- TASK CHECKPOINTABLE 


An RSX-11M error message. The subject task was 
checkpointable. A checkpointable task cannot be fixed 
in memory. Remove the task and install it as 
non-checkpointable (/CKP=NO). You can then fix the 
task in memory. 
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The Install command makes a specified task known to the system, An 
installed task is dormant until the Executive receives a request for 
it to run. Install accepts optional keywords which provide parameters 
that were not specified at task build or override previously specified 
parameters. 


When you install a resident library in an RSX-11M system, Install 
loads it into a common partition. 


When you install a resident library in an RSX-11M-PLUS system, Install 
makes an entry for the resident library in the Common Block Directory 
(CBD). Install loads the resident library when a task that uses it 
runs and removes the resident library when no task is attached to it. 


When a task is installed, the system creates a Task Control Block 
(TCB) for the task in a memory-resident table called the System Task 
Directory (STD). The task parameters contained in the TCB enable’ the 
system to run the task when requested to do so by an MCR command or a 
system directive. A task cannot be run until it has been installed. 
(See Section 1.3.1.) (Note that the Run command has an option that 
automatically installs and removes a task before and after running 
it.) 


A task's TCB contains the address of the load-device Unit Control 
Block (UCB) and the Logical Block Number (LBN) of the task image file. 
The Executive can therefore load the task image in one transfer when 
an MCR command or system directive requests an installed task. 
(Loading requires more than one transfer if the task is greater than 
32K words.) 


When you install a task, the system stores the task image file's LBN 
in the task header. When a system is saved, the Save task places the 
file identification, rather than the file's LBN, in the TCB. Then 
when the system is rebooted, it reopens the task file and stores the 
new current LBN of the task in the TCB. I£ a task has been deleted, 
the system cannot open the task file when the system is rebooted. The 
system then automatically removes the task's TCB from the STD. 


NOTE 


If an installed task's file image is 
deleted and other data is written into 
that area, the system probably will 
crash if you attempt to activate the 
deleted task. A crash also occurs if 
the disk from which the task was 
installed is removed and replaced with a 
different disk. This is because an 
Executive table in the task image (the 
task header) will contain random data. 
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A saved system does not retain the physical addresses of installed 
tasks. The Disk Save and Compress (DSC) and Backup and Restore (BRU) 
utilities can compress and copy a disk containing a saved system, thus 
moving the task files to different physical locations. But since the 
TCB entries contain task file identifications, rather than LBNs, after 
a system save, the system can function normally when it is rebooted. 
Format: 
INS[TALL] [$]filespec [/keyword(s) ] 
Keywords: 
/AFF=(CPx,UBy] (RSX-11M-PLUS multiprocessor systems) 
/CKP=option 
/EST=option 
/INC=size 
/PAR=pname 
/PMD=option 


/PRI=number 


/PRO=[system, owner, group,world] (RSX-11M-PLUS systems) 
/RON=option (RSX-11M-PLUS systems) 
/ROPAR=parname (RSX-11M-PLUS systems) 


/SLV=option 
SYNC=option (RSX-11M-PLUS multiprocessor systems) 
/TASK=taskname 
/VIC=[group, member ] 
where: 
filespec - The file specifier in the form: 
dev: [group, member]filename.type;version 


The type defaults to TSK; Standard defaults 
apply to the remaining fields. 


If $ is specified in the command line, then dev: 
defaults to LB:, and [group,member] defaults to 
the current system UIC (usually, [1,50] in an 

mapped system). 
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CKP 


EST 


INC 


/CKP=option. Checkpoint option. The two options 
are YES and NO. If /CKP=YES (default for 
checkpointable tasks), checkpointing is allowed. 
If /CKP=NO, checkpointing is disabled for the 
task. 


The /CKP keyword overrides’ the /CP switch 
specified at task build. 


On systems that support the dynamic allocation of 
checkpoint space, the task image file does not 
need to contain allocated checkpoint space. The 
presence of the /CKP=YES keyword instructs the 
system to allocate checkpoint space, when 
required, for the task from a checkpoint file. 


/EST=option. Exit status option. The two 
options are YES and NO. If /EST=YES, the install 
task waits for any task it spawns to complete and 
emit exit status before continuing. If /EST=NO, 
the install task does not wait for exit status 
from its offspring; as soon as the install for 
the spawned task completes, the parent’ task 
executes. 


Default: /EST=YES; parent tasks do not exit 
until their offspring task emits exit status. 


/INC=size. The number of additional words of 
address space to allocate a task that runs in a 
system-controlled partition. The extension size 
is usually expressed in octal, but may also be 
expressed in decimal by appending a period. This 
keyword overrides the EXTTSK or PAR parameter 
used at task-build time. Tasks that specify the 
size of the partition in which they are running 
use this keyword to identify how much dynamic 
space they may allocate to symbol tables or 
buffers. Tasks such as MAC, TKB, PIP, VFY, and 
AT. use the space from the end of the task image 
to the end of their address space as dynamic 
memory. In effect, the /INC keyword defines the 
number of words in this dynamic region. 
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In an RSX-11M/M-PLUS system, you cannot extend a 
task that uses memory-resident overlays. See the 


RSX-11M/M-PLUS Task Builder Manual. 


Default: either the size specified at task-build 
time, or zero, 


/PAR=pname. A partition name that overrides the 
partition specified at task-build time. In an 
unmapped system, the specified partition must 
have the same base address as the partition for 
which the task was built. 


If the keyword specifies a nonexistent partition, 
the system issues a warning message and attempts 
to install the task in the GEN partition. 


Default: TKB uses the name GEN. (See the 
RSX-11M or RSX-11M-PLUS System Generation and 
Management Guide for an explanation of multiuser 
system defaults. ) 


7PMD=option. Post-Mortem Dump option. The two 
options are YES and NO. If /PMD=YES, a 
post-mortem dump occurs if the task aborts 
because of an SST error condition. If /PMD=NO 
(the default from a task-build), no dump is 
requested at SST abort time. To generate a dump, 
the post-mortem dump task PMD... must be 
installed in the system. This keyword overrides 
the /PM switch specified at task-build time. 


Default: specified at task~-build time. 


/PRI=number. Priority number. The value range 
is 1 through 250(10). Standard numbering 
conventions apply; octal by default, decimal if 
followed by a period. 


Default: /PRI=50. 


/PRO=[system, owner, group,world]. An RSX-11M-PLUS 
keyword. Installed common’ region protection 
option. Access codes consist of four 4-code 
groups in the access rights word of the common 
region as follows: 


R = Read 

W = Write 

E = Extend 
D = Delete 
* = Default 


In each instance, the absence of the code means 
that the applicable user is denied the access 
right. The square brackets are required syntax. 
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SLV 


Specify an asterisk (*) in the access rights word 
to force the default value for a specific group. 


Defaults: {RWED, RWED, RWED, RWED]. 


Note that you cannot specify protection options 
for a read-only common region or the read-only 
portion of a multiuser task. 


/SLV=option. Slave task option. The two options 


are YES and NO. If the command specifies 
/SLV=YES, data sent to the installed task is 
marked with the TI: of the sending task. When 
the installed task receives the data, the system 
sets the task's TI: to that associated with the 
data. This keyword overrides the /SL_ switch 
specified at task build. 


If the command specifies /SLV=NO the TI: of the 
task does not change when receiving data. 


Default: Specified at task build. 


4-150 


TASK - 


Examples: 


“INSTALL SCAN 


MCR COMMANDS 


INS (Cont.) 


/TASK=taskname. The name by which the system 
refers to the task. 


Default: first 6 characters of the filename or 
the name specified at task-build time. (See the 
RSX-11M or RSX-11M-PLUS System Generation and 
Management Guide for an explanation of multiuser 
system defaults.) 


/UIC=[group,member]. The square brackets are 
required syntax. This UIC is the default for the 
task. It can be overridden in the Run command. 
The task UIC determines into what file~-protection 
class (system, owner, group, world) a task 
belongs, and thus directly influences’ file 
access. Note that file protection may differ 
from file to file. 


Default: default from task build. This default 
applies only to tasks started by a RUNS directive 
or an MCR Run command that specifies a time delay 
before runtime. Tasks started by typing the name 
as a command (for example, PIP and TKB) run under 
the default UIC of the terminal from which the 
command was issued. This UIC is defined by the 
Set command or at login. 


Install task SCAN. Priority and UIC defaulted. 


PINSTALL DKi:sCisiLLISCAN. TSK I4/PRI=103 


Install task SCAN, file type TSK, version 4 on device DKl:, 
group number 1, member number 111, with a priority of 


103(8). 


*INS MAC/INC=409G6./PAR=SYSCTL 


Install task MAC in the system-controlled partition SYSCTL 
and increase the task size by 4096 (10) words. 
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Command Error Messages: 


INS -- ADDRESSING EXTENSIONS NOT SUPPORTED 


INS 


INS 


INS 


INS 


INS 


INS 


INS 


The command tried to install a task with a VSECT 
(virtual section) into a system that does not support 
the feature. 


BASE ADDRESS MUST BE ON 4K BOUNDARY 


The base virtual address of the task was not on a 4K 
boundary. This message is applicable only to mapped 
systems. 


BASE MISMATCH COMMON BLOCK <common-name> 


The base address of the partition did not match that 
of the common block. This message is applicable only 
to unmapped systems. 


CANNOT INSTALL PRIVILEGED TASK FROM NON-PRIVILEGED TERMINAL 


This message applies to multiuser protection systems 
only. A nonprivleged user attempted to install a 
privileged task. Only a privileged user can install a 
privleged task. 


CHECKPOINT AREA TOO SMALL 


The area allocated for checkpointing the task was 
smaller than the partition into which the task was 
being installed. This message applies only to systems 
that do not support the dynamic allocation of 
checkpoint space, 


CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 


A warning message. The checkpoint space allocated in 
the task image file is too small for the size of the 
task (usually because of the /INC’ keyword). The 
system supports the dynamic allocation of checkpoint 
Space and will therefore use a checkpoint file to 
contain the checkpointed task. 


COMMON BLOCK IS TASK PARTITION <common-name> 
A task's request for access to a common block was 
rejected because the requested partition was a task 
partition. 

COMMON BLOCK NOT LOADED <common-name> 
The specified common block was linked to the task but 


had not been installed into the system. Install the 
common block, then insStall the task. 
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_ : 
INS -- COMMON BLOCK OCCUPIED 
An attempt was made to load a common block that was 
occupied. 
INS -- COMMON BLOCK PARAMETER MISMATCH <common-name> 
Parameters of a common block did not match those in 
the task's label block. 
INS -- COMMON BLOCK SEGMENT COUNT ERROR 
The command installed a resident library with 
overlays, but the number of overlay segments specified 
in the task header was different from the number 
specified in the segment descriptions. 
i) INS -- FILE NOT CONTIGUOUS 
An attempt was made to install a_ task from a 
non-contiguous’ file. Task images may exist only in 
contiguous files. 
INS -- FILE NOT TASK IMAGE 
Data in the label block was not correct, indicating 
that the file was not a task image. 
= INS -- ILLEGAL DEVICE ddnn: 
aw ; ; ; 
The device specified at task build by the assign (ASG ) 
options did not exist in the system. This is a 
warning message; the task will be installed. 
INS -- ILLEGAL DEVICE/VOLUME 
The specified device was not a valid task-residence 
device. 
INS -- ILLEGAL FIRST APR 
wy A privileged task, built to run using APR 4 or 5 as 
its base, waS too large. Using APR 4, the task was 
larger than 12K; using APR 5, the task was larger 
than 8K. If the Executive has been built to support 
20K of address space, APR 5 is the only valid base APR 
for tasks mapping into the Executive. A privileged 
task that does not map into the Executive must use APR 
0 as its base. (See the RSX-11M/M-PLUS Task Builder 
Manual for a description of the /PR keyword.) This 
message applies only to mapped systems. 
INS -~- ILLEGAL PRIORITY 
The value of the priority specified in the command was 
out of range (that is, not 1 to 250(10), inclusive). 
e z 
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INS -- LENGTH MISMATCH COMMON BLOCK <blockname> 


The length parameter for the common block, as 
described in the label block for the task image, did 
not match the corresponding length parameter defined 
in the system. A task's label block data must match 
system data for that task before it can be installed. 


INS -- NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 


This is a warning message. The command attempted to 
install the task as checkpointable; but the task was 
not built as checkpointable and therefore had no 
checkpoint Space allocated in its task image file. 
Because the system does not support the dynamic 
allocation of checkpoint space, it considers the task 
not to be checkpointable,. 


INS -~- NO ROOM AVAILABLE IN STD FOR NEW TASK 


No dynamic memory was available to build the System 
Task Directory (STD) entry (Task Control Block {TCB]); 
therefore, no task could be installed. 


INS -- NOT ENOUGH APRS FOR TASK IMAGE 


The Task Builder allows the user to specify the 
virtual base address of a task image as a multiple of 
4K. Privileged tasks start at virtual 100000(8) to 
map the first 16K of the Executive, or virtual 
120000(8) to map the first 20K of the Executive, at 
the same time as the user task. If the virtual base 
address is set too high, the task image may not be 
able to be mapped with the remaining mapping 
registers, This message is applicable to mapped 
systems only. 


INS -~- PARTITION NOT COMMON 


A partition specified for a common area or library is 
not defined as a common partition. 


INS -- PARTITION par NOT IN SYSTEM, DEFAULTING TO GEN 
This is a warning message. The specified partition 
does not exist; the system therefore attempts to 
install the task in the GEN partition. 

INS -- PRIVILEGED TASK LARGER THAN 12K 
A privileged task was larger than 12K. Privileged 
tasks on an unmapped system have a maximum size of 
12K. 

INS -- SPECIFIED PARTITION FOR COMMON BLOCK 


A task was being installed into a common block. 
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-- SPECIFIED PARTITION TOO SMALL 


The task being installed was larger than the partition 
into which it was being installed. 


TASK AND PARTITION BASES MISMATCH 


The base of the partition did not match the base of 
the task being installed. This message applies only 
to unmapped systems. 


TASK IMAGE ALREADY INSTALLED 


The requested task image, which was checkpointable, 
had already been installed. On systems that do not 
support the dynamic allocation of checkpoint space, 
checkpointable tasks that have checkpoint space 
allocated can be installed only once; other tasks can 
be installed more than once (under different names). 


TASK IMAGE I/O ERROR 


Install could not read the task-image file, or Install 
could not rewrite the task-image header. (The device 
is write-locked. ) 


TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK 
<block-name> 


The virtual addresses reserved for the task image 
overlap those reserved for the common block specified 
in the message. A corruption of the task image file 
probably caused the overlap. 

TASK NAME ALREADY IN USE 


An attempt was made to install a task with the same 
name as one already in the system. 


TOO MANY COMMON BLOCK REQUESTS 


A task made too many common-block requests. A task is 
limited to seven common-block references. 


TOO MANY LUNS 


A task requested more than 255(10) LUN's' to be 
assigned. 


UNDEFINED COMMON BLOCK <blockname> 
A task referenced a common block that had not been 


defined in the system. Usually, this message 
indicates that the task was built for another system. 
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INS -- WARNING -- PRIVILEGED TASK OVERMAPS THE I/O PAGE 


A privileged task that is mapped into the Executive is 
usually also mapped into the I/0 page in order to 
access the KT1ll registers and other devices. Many 
tasks do not require this access and can use the 
additional 4K words of virtual address space for the 
task image. This message warns that a task that may 


require access to the I/O page might have grown too 
large. 
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LOAD 


The Load command reads a nonresident (loadable) device driver into 
memory and, if necessary, relocates the data base constructs and 
interrupt-vector linkages required to allow access to the device. 
(Note that under RSX-11M-PLUS, the task CON constructs 
interrupt-vector linkages.) This command eliminates the need to link 
infrequently used device drivers permanently into the Executive. 
(Executive support of loadable device drivers is a system generation 
option.) The result is the potential for an increase in the amount of 
system dynamic memory. 


You can load drivers that are up to 8K _ words in length. Note, 
however, that the loadable device driver itself must map to any 
locations above 4K. 


The driver for a device, for example ZY:, can indicate association 
with a common partition for RSX-11M or a region for RSX-11M-PLUS by 
allocating one word in the driver and labeling it with the global 
symbol $ZYCOM. If $ZYCOM is defined in a driver, you cannot load the 
driver until you create ZYCOM (LOA writes the PCB address of ZYCOM 
into S$ZYCOM). 


Format: 

LOA[D] dd: [/keyword(s) ] 

where: 

dd: —~ a 2-character ASCII loadable device driver name 

Keywords: 

/PAR=parname 

/CTB=cca[,.b...] (RSX-11M-PLUS systems only) 

/SIZE=parsize 

/HIGH 


Keyword Definitions: 


PAR - /PAR=parname. Specifies the partition (parname) into 
which the driver is to be loaded. 


In an RSX-11M system, the specified partition cannot be 
a common partition, but all other types are 
permissible. 


All loadable drivers are usually placed in the same 
partition, by convention DRVPAR. This has’ the 
advantage of preventing fragmentation of the GEN 
partition and normally ensures that all loadable 
drivers remain below 124K in memory (the maximum core 
image size for the Save task). 
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If the command omits this keyword, the system loads the 
driver into the partition specified when the driver was 
built. 


SIZE - /SI2ZE=parsize. Specifies the minimum size (in words) 
of the partition into which the driver is to be loaded. 
If the partition is system controlled, the created 
subpartition will be this size, 


parsize is rounded up to the next highest unit of 100 
(octal) and must be less than 100000. 


HIGH - /HIGH. I£ the partition is system controlled, /HIGH 
causes the driver to be loaded as high in the partition 
as possible; absence of /HIGH loads the driver as low 
in the partition as possible. 


If the partition is not system controlled, the driver 
occupies the entire partition whether or net you 
specify /HIGH. 


Examples: 


“LOAD MMs ‘LOAD TUIG DRIVER (MMDRY) 
“LOA LP:/PAR=DRYVPAR 'LOAD LP11 DRIVER (LPDRV) INTO DRUPAR 
Notes: 
e Guidelines for building loadable device-driver tasks are 


rigidly defined. These guidelines are described in the RSX-11M 
or RSX-11M-PLUS Guide to Writing an I/O Driver. Note that the 
system generation procedures include provisions to simplify the 
task building of drivers, 


e It is not possible to make all device drivers loadable. Also, 
not all loadable drivers can have loadable data bases. 
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The Load command requires that a driver's TSK and STB. files 
reside under the system UIC on the system disk (LB:). For 
example, the command 


LOA DT: 


requires that the files DTDRV.TSK and DTDRV.STB reside on LB: 
under the appropriate system UIC. The command SET /SYSUIC 
displays and defines the system UIC; the usual values, 
however, are [1,50] for an unmapped system and [1,54] for a 
Mapped system. 


The Load command does not initiate checkpointing to free a 
space in a partition. 


The Load command requires pool space as follows: 


1. If the driver data base is being loaded, the command 
needs contiguous pool space equal in size to the size 
of the data base. 


2. In a mapped system, the command needs pool space _ for 
an Interrupt Control Block (ICB) for each interrupt 
entry in the driver. 


3. If the driver is being loaded into a system-controlled 
partition, the command needs pool space for a 
Partition Control Block (PCB). 


Command Error Messages: 


LOA -- CANNOT LOAD/UNLOAD A PSEUDO DEVICE 


The device you attempted to load is a pseudo device. 
Pseudo devices do not have drivers. 
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LOA -- DEVICE dd: NOT IN SYSTEM 


The data base for the device driver was neither in the 
system nor in the driver's task image. 


LOA -- DEVICE NOT MOUNTED 
The system device (LB:) was not mounted. 
LOA -- DRIVER ALREADY RESIDENT 


The specified device driver had already been loaded or 
is permanently resident. . 


LOA -- DRIVER BEING LOADED OR UNLOADED 


The Executive was effecting another request to load 
the driver. 


LOA -- DRIVER BUILT WITH WRONG EXECUTIVE STB FILE 


The STB file for the driver was not compatible with 
the current Executive. The task build probably 
specified an RSX-11M.STB that was not for the current 
system. 


LOA -- DRIVER LOAD/UNLOAD CALLS NOT SUPPORTED 
An RSX-11M message. The requested driver included the 
global symbols $ddLOA or $ddUNL in its source. These 
symbols are reserved for future use by the Load and 
Unload commands. 

LOA -- FILE filename HAS ILLEGAL STB FORMAT 


The driver's STB file contained an illegal object code 
or data record format. 


LOA -- FILE filename NOT A VALID DRIVER TASK IMAGE 


The driver's task image was either overlaid or had a 
task header. 
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FILE ddDRV.TSK NOT CONTIGUOUS 


The file ddDRV.TSK was not contiguous. Device dri 
(like all "task" images), must be contiguous. 


ILLEGAL DRIVER TASK APR USAGE 


A device driver must be built for APR 5 and must 
less than 8K (for example, PAR=DRVPAR:120000:400 
This message applies to mapped systems only. 


ILLEGAL VALUE FOR SYMBOL symname IN FILE filename 


The symbol symname is defined to an illegal value 
file ddDRV.STB. This can occur for several reas 
some general and some specific to individual symb 
For example, symbols cannot have odd values; 
symbols cannot be defined as zero; S$ddTBL must e 
and have a value less than S$ddEND; mapped load 
drivers cannot reference SINTSV. 


INSUFFICIENT POOL SPACE 


The required amount of system dynamic memory was 
available. 


INTERRUPT VECTOR ALREADY IN USE 


An RSX-11M message. A driver interrupt vector 
not point to one of the nonsense interrupt e 
points. 


vers 


be 
00). 


in 
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not 


does 
ntry 


INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE filename 


The driver had an invalid data base value at of 
xxxx relative to the symbol $ddDAT. This can o 
for three general reasons. There is something 


fset 
ecur 
very 


specific wrong with the word in question; such as 


D.UCB being odd, a conclusion Load made starting 
the word in error. 
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For example, D.UCB, D.UCBL, D.UNIT, and D.UNIT+1 
define the address of the last word of the last UCB. 
If that word is not within the bounds of the loadable 
database, Load produces an error message citing 
D.UNIT. Load is off the track and is attempting to 
verify one kind of data structure as a different type. 
For example, in an RSX-1l1M-PLUS system, if the 
loadable database starts with a CTB and the global 
symbol $ddDCB is not in the database, Load assumes 
that the DCB is the first structure in the database. 
Therefore, Load cites a word in the CTB as bad. 


LOA -- INVALID INTERRUPT VECTOR 


An RSX-11M message. The interrupt vector address 
specified in the driver data base was too high for the 
current system. 


The system generation option to support loadable 
device drivers was not chosen or necessary routines 
are not in the Executive. 


LOA -- OPEN FAILURE ON FILE filename 


Load encounted an error in attempting to open the 
specified file. 


LOA -- PARTITION parname BUSY 


In an RSX-11M system, the user-controlled partition or 
subpartition into which the driver was to be loaded 
was already occupied. 
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LOA-- PARTITION parname IS A COMMON 


An RSX-11M error message. You have attempted to load 
a device driver into a common partition. A device 
driver cannot be loaded into a common partition. 


LOA -- PARTITION parname IS NOT A COMMON 


An RSX-11M error message. The symbol S$ddCoM is 
globally defined in the driver. The partition ddCOM 
exists, but it is not a common partition. 


LOA -- PARTITION parname NOT IN SYSTEM 


An RSX-11M error message. The partition specified 
either in the Load command or at task build was not in 
the system. 


LOA -~ PARTITION parname TOO SMALL 


The partition into which the driver was to be loaded 
was not large enough to contain it. 


LOA -- REGION/PARTITION name IS A COMMON 
You have attempted to load a device driver into a 
common partition. A device driver cannot be loaded 
into a common partition. 


LOA -- SYMBOL symname IS DOUBLY DEFINED BY FILE filename 


The symbol symname is defined twice by the file 
ddDRV.STB 
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LOA -- SYMBOL symname IS UNDEFINED IN FILE filename 


The symbol symname was found in the file ddDRV.STB, 
but it was not a symbol definition. 


LOA -- TASK AND PARTITION parname BASES MISMATCH 


An RSX-11M message. The base address of the partition 
into which the driver was to be loaded did not match 
the base address of the partition address for which 


the task was built. This message applies to unmapped 
systems only. 


LOA ~- TASK IMAGE I/O ERROR IN FILE filename 
The device is probably write-locked. Load could not 


read the task-image file or could not rewrite the task 
image header. 


LOA 


WARNING - LOADABLE DRIVER LARGER THAN 4K 
Loadable drivers can be up to 8K words in length. The 


driver must explicitly map to any location above 4K 
words. 
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OPEN REGISTER 
The Open Register command allows examination and optional modification 
of aword of memory. To open a location within a task, the task must 
be fixed in memory. 
Format: 

OPE[N] memory address [+ or <n] [/keyword] 


(memory-address) (contents-of-address)/[value]<line-terminator> 


The Open command, as shown above, is a 2-line command. The first 
line initiates the command. Its parameters are as follows: 


memory-address - A l- to 8-digit octal memory address. 

+ or -n - One or more optional octal numbers to be 
added to or subtracted from the memory 
address. 


Keywords: 


/AFF=([CPx, UBy] (RSX-11M-PLUS multiprocessor systems) 
/CPU=CPx (RSX-11M-PLUS multiprocessor systems) 
/TASK=taskname 

/PAR=partition name (RSX-11M systems) 

/REG=region name (RSX-11M-PLUS systems) 


/KNL 

/KNLD (RSX-11M-PLUS systems) 
/KNLI (RSX-11M-PLUS systems) 
/DRV=dd: 


The keywords apply only to mapped systems. 


Keyword Definitions: 


TASK - /TASK=taskname. Accesses an address relative to the 
specified task (the task partition). Note that the 
task must be fixed. 


PAR - /PAR=partition name. An RSX-11M keyword. Accesses an 
address relative to the beginning of the specified 
partition. 


KNL - /KNL. Accesses the first 32K of Executive memory. In 
an RSX-11M-PLUS system supporting Instruction and Data 
(I and D) space, the keyword accesses and prints’ the 
contents of addresses in the Executive data space. 
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An 8 LIM-PLUS 


DRV - JORV=aa: ; accesses an address relative to the 
beginning of the partition that contains the loadable 
driver for the specified device. 


‘After accepting the first input line, Open finds the memory location 
to be accessed by using either: 


e The keyword (in a mapped system) 
e The specified address as the actual address 


When /TASK, /PAR, /REG, and /DRV are used, the supplied memory address 
(a virtual address in the partition) is modified by + or - n. The 
absolute address thus formed is used to display the second line shown 
in the command format. In particular, the virtual address (task, 
partition, or kernel) and its contents are displayed. You may then 
enter an optional replacement value, followed by a line terminator. 


In a mapped RSX-11M system, an attempt to specify an illegal location 
or access beyond the limits of the partition causes an error. The 
user is limited to the specified memory region (TASK, PAR, or DRV). 
However, if the command omits a keyword, it can access any address of 
physical memory. In an unmapped RSX-11M system, any location in 
physical memory can be accessed. 


| /AFP keyword. Li 
syou MUSE trea 


The line Esrninater maceeee: the subsequent action of Open. Any value 
that is entered replaces the contents of the word whose address and 
current value are shown in the first part of the line-2 display. The 
slash (/) is part of the line-2 display. 


Line Terminator Options: 


ESC - ESCape or ALTMODE: (ALTMODE) terminates 
acceptance of further input and is the only means of 
exit from the MCR Open function. 


RET - Carriage return: the next sequential location is 
opened. 
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RET - Up-arrow (circumflex on some terminals) carriage 
return: the previous location is opened. 


*Ceror @Cae)- Asterisk carriage return, or at-sign carriage 
return: the location pointed to by the contents of 
the opened location is opened. 


> Crer - Right angle bracket carriage return; the contents 
of the open location is treated as a branch 
instruction. The effective address of the branch is 
the next opened location. It is not permissible to 
supply a value (modify the current open location) 
and close the location with a >. 


Example: 


OPE 4+10/TASK=CYCLE 
OoOoOoOLA OBOOL4/3S0ESC 


In this example, the specified virtual address in the task CYCLE 
is 4, while n equals 10, yielding the effective task-relative 
address of 000014. The system responds by printing the virtual 
address (000014), and the contents of the address (060014), 
followed by the slash. The operator responds by entering the new 
value 350 and the ESCape character. The value 350 replaces the 
previous contents of task virtual location 000014. 


Command Error Messages: 
OPE -- BYTE ADDRESS 


The address specified as the argument to the Open 
command was an odd address. 


An even address (for example, 3000) is legal; an odd 
address (for example, 3001) is illegal. 


OPE -- INPUT I/O ERROR 


In attempting to read the next command, Open detected 
an error. 


OPE -- INVALID ADDRESS 


The address specified as an argument in the Open 
command referenced a nonexistent memory location, an 
address outside of the specified partition, or an 
address outside of the task's virtual address space. 


OPE -- TASK NOT FIXED 


An attempt was made to open a task virtual location. 
Since the task was not fixed, it may or may not have 
been in memory at the time the command was issued. 
This message indicates that the specified task was not 
in memory when the command was issued. 
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REASSIGN 
This command reassigns a task's Logical Unit Numbers (LUNS) from one 
physical device-unit to another. The reassignments affect only the 
static assignments recorded in the task's disk image file. 
The command does not affect a memory-resident task. Hence, Reassign 
has no effect on the assignments of a currently executing task, nor on 
those of a task that is fixed in memory. Use the Redirect command for 
dynamic device reassignments. 
Format: 
REA[SSIGN] taskname lun ddn: 
where: 
taskname - is the name of the task 
lun - Logical unit number 
ddn: - New device-unit, which can be a physical, logical, 
or pseudo device. 
Examples: 
°REA JOE 9 TTO: 
Reassign LUN 3 of task JOE to device TTO:. 
“REA BILL @ TTi:s 
Reassign LUN 2 of task BILL to device TTl:. 
*REA TEST 3 Xx: 
Reassign LUN 3 of task TEST to logical device XxX:. 
Command Error Message: 
REA -- LUN OUT OF RANGE 
An attempt was made to reassign a LUN that was greater 


than the maximum number of LUNs allocated during task 
build. 
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REDIRECT 
This command redirects all I/O requests previously directed to one 
physical device-unit to another physical device-unit. The Redirect 
command is especially useful if I/O units required for a task are 
inoperable. The command does not affect any I/O requests aleady in 
the I/O queue. 
You cannot redirect the following device-units: 

e The device TI: 

e An attached device 


e A device-unit containing a mounted volume 


oe es BEES 
In addition, you cannot redirect one pseudo device to another pseudo 
device nor can you redirect a logged in terminal to a device other 


than a terminal. 
Format: 


RED[IRECT] nddn:=oddn: 


wheres: 
nddn: - New device-unit to which subsequent requests will be 
redirected. 
oddn: - Old device-unit from which requests have been 
directed. 
Example: 


“RED TTGs=TTGs 


Redirect all I/O requests for device TT6: to device TT3:. 
(RED TT6:=TT6: .restores I/O requests for TT6:.) 


Command Error Messages: 
RED -~- CIRCULAR REDIRECT ERROR 


The attempt to redirect a device would result in a 
circular list of redirections. 


RED -- DEVICE NOT REDIRECTABLE 


An attempt was made to redirect a device that cannot 
be redirected. 


RED -- NEW DEVICE NOT KNOWN TO SYSTEM 


The new device in the Redirect command was not’ known 
to the system (did not exist in the device tables). 
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RED 


RED 


RED 


RED 


RED 


OLD DEVICE ATTACHED 

An attempt was made to redirect an attached device. 
OLD DEVICE MOUNTED 

An attempt was made to redirect a mounted device. 
OLD DEVICE NOT KNOWN TO SYSTEM 


An attempt was made to redirect an unknown device (the 
device did not exist in the device tables). 


PSEUDO DEVICE REDIRECT ERROR 


An attempt was made to redirect one pseudo device to 
another pseudo device. 


TI REDIRECT ERROR 


An attempt was made to redirect the pseudo device TI:. 
This device may not be redirected. 
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REMOVE 


The Remove command deletes an entry (a task name) from the System Task 
Directory (STD), and thereby removes the task from the system. The 
removal of a task from the system makes the task unknown to_ the 
system. This action is the complement of Install. All that remains 
of the task in the system is the task-image file. 


To remove a task that is in execution, you must first abort the task. 
Format: 
REM[OVE] taskname 


where taskname is the name of the task to remove. 


be we ese 


Example 
[REM SCAN 
Remove the task named SCAN from the system. The task-image 
file is not deleted. 
Notes: 


e If a task that is the object of a Remove command is fixed, the 
command unfixes the task and then removes it. 


e Remove cancels all time-based schedule requests for the 
specified task. 


e Remove unlinks a task from all ICS/ICR interrupts. 


e Remove deallocates all receive-by-reference and receive-data 
packets for the task, and detaches all attached regions. (See 


the RSX-11M/M-PLUS Executive Reference Manual.) 
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SAVE 

The Save command copies the current system image (the contents of main 
memory up to 124K) of an RSX-11M/M-PLUS system into the system image 
file from which the current image was booted. (The system image file 
is a special task-image file named, by convention, RSX11M.SYS.) The 
command saves the image so that a hardware bootstrap or the Boot 
command can later be used to reload and restart it. 

All RSX-11M/M-PLUS system images reside on a file-structured volume as 
a special format task image. This special format is a task image 
without a task header. There may be more than one system image on a 
volume (for example, a program development system and a production or 
test system) and nonprivileged tasks can be installed in several 
system images at the same time. 


To determine the minimum size for a system image file, compute’ the 
formula of four times the size plus two. For example: 


28K requires 114. blocks 
32K requires 130. blocks 
124K requires 498. blocks 
To successfully save a system, the Save command requires that: 


1. On an RSX-11M system, Save must run from CO: (RSX-11M-PLUS 
does not require this) 


2. Error logging is not active 

3. All tasks be installed from an LB: 

4. No checkpoint files are active 

5. No volumes are mounted, except the load device 
6. The load device can be successfully dismounted 
7. No tasks have outstanding I/0 


8. No tasks are connected to interrupts 


9. All drivers, active tasks, fixed tasks and, in RSX-11M-PLUS 
systems, all loaded commons reside within the amount of main 
memory that Save will write to the system image file 
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An error is reported if any of the above requirements is not met. 


Save is active when the memory-resident system image is copied to 
disk, and thus Save appears in this image as an active task to VMR. 
This appearance is correct because Save is the task that starts the 
system after a boot. 


The Executive references the file images of installed tasks _ by 
physical addresses (LBNs). A saved system does not always retain the 
physical disk addresses of installed tasks; for example, the Disk 
Save and Compress utility can compress and copy a disk containing a 
saved system, thus moving the task files to different physical 
locations. Therefore, Save converts the LBNs of all installed tasks 
into file identifications and stores these in the TCBs. Since the TCB 
entries contain task file identifications rather than LBNs after a 
system save, the system can function normally when it is rebooted, 
even if LBNs have changed in the meantime. Upon system reboot, Save 
reopens the task file and stores the new LBN of the task in the TCB. 
If a task has been deleted, the system cannot open the task file when 
the system is rebooted. In this case, the system automatically 
removes the task's TCB from the STD. In RSX-l1M-PLUS systems, since 
installed common regions and read-only segments of multiuser tasks 
face a similiar problem, Save also converts the absolute pointers for 
these into relative pointers and restores the pointers when the system 
is booted. 


When the bootstrap block is written, the physical disk-block address 
of the system-image file is stored with it. However, the file can be 
deleted. If there is file system activity, the blocks previously 
allocated to the system image may be reallocated to another file. A 
subsequent bootstrap that uses the boot block could possibly cause 
random data to be loaded. 


Upon reboot of a saved system, Save: 
e Selects the system clock 
e If the last memory partition is system controlled, sizes 
memory and extends the partition so that it uses all available 


memory. 


@® In multiuser protection systems, validates that the boot 
device is not allocated and then sets it public 


e Sets the context of the console terminal as logged in, 
privileged, and non-slaved 
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Sizes the boot device (RSX-11M-PLUS systems) 


Outputs system identification message 


Redirects all pseudo devices to the boot device 


Mounts the system disk 


Initiates the file [1,2]STARTUP.CMD on the booted device 


e 
e 
e 
e 
@ 
Format: 
SAV [E] 
Keywords: 
/WB 
/MOU 
/SFILE 
/NOCON 
/CSR 


Keyword Definitions: 


WB 


MOU 


SPILE 


[/keyword(s) ] 


(RSX-11M-PLUS systems) 
(RSX-11M-PLUS systems) 


- /WB. Indicates that a hardware boot block 


pointing to the system image is to be written out 
to the system device. The new boot block points 
to the file that is saved with the issuance of the 
command. Thus, on the next hardware bootstrap, 
this saved file will be loaded. If the command 
omits the /WB keyword, the boot block still points 
to the prior system image, which may have been 
overwritten. 


/MOU-"String". The Save task automatically issues 
an MCR Mount command at system startup to mount 
the system disk. This keyword allows you to 
specify options to be appended to that Mount 
command. 


The Mount command options you specify must _ be 
enclosed within quotes and must be in the proper 
format for Mount options (that is, including a1l1 
necessary Slashes (/) or equal signs (=)). Note 
that Save performs no syntax checking of the 
string. 


/SFILE="filespec". The Save task automatically 
initiates an indirect command file 
({1,2]STARTUP.CMD) on the boot device at system 
startup. This keyword allows you to specify 
another indirect command file. 


The command file you specify must be enclosed 


within quotes. Note that Save performs no syntax 
checking of filespec. 
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Example 
SAY 


The current status of the system is saved on the system 
disk. System changes made by the Redirect command or other 
MCR commands are also saved with the system image that is 
resident in main memory. 


Command Error Messages: 
SAV -- BAD TASK FILE VBN, TASK REMOVED - taskname 


Save removed the specified task because it contained a 
bad virtual block number (VBN) in its file header. 
The task image file has probably been corrupted. 


SAV -- BOOTED DEVICE'S DRIVER NOT LOADED 


VMR has been used to unload the driver for the system 
(booted) disk. Using another system, use VMR to load 
the driver and then reboot the system. 


SAV -- BOOTED DEVICE NOT IN SYSTEM - dd nnn mmmmmm 


When the system was booted, Save could not find the 
booted device (device name dd, physical unit number 
nnn, CSR mmmmmm) in the system data structures. For 
example, the system was booted from DB3:, but the 
system data structures include only DBO and DBl: 
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SAV -- CHECKPOINT FILE STILL IN USE ON ddnn: 


SAV -- CO: 


The system cannot be saved because a checkpoint file 
on the specified device is still active. Deallocate 
the checkpoint file (see the ACS command) and reissue 
the Save command. 


REDIRECTED TO CO: 
The console output driver is active. If it is not 
active, the system may be corrupted. You can use the 


Open command to redirect CO: to the terminal from 
which you are running Save. 


SAV -- COMMON, DRIVER OR TASK ABOVE SYSTEM IMAGE FILE LIMIT 


A system cannot be saved if a memory-resident 
structure is higher than the amount of main memory 
that is written to the system image file. Use the 
Partitions command to determine the cause of the 
problem. This includes the running task image of 
Save. 


SAV -- DISMOUNT COMPLETE FOR ddnn: 


This is not an error message. The message indicates 
that TKTN is not installed in the running system. If 
the load device is mounted when Save starts, Save 
attempts to dismount it. Since TKTN is not installed, 
the dismount complete message from DMO is not 
displayed on the console terminal. As a substitute, 
Save writes this message to the terminal. 


SAV -- ERROR ATTEMPTING TO DISMOUNT ddnn: 


If the load device is mounted when Save is initiated, 
Save issues a Dismount command to MCR. This message 
indicates that the dismount operation was not 
successful. The system may be usable, but it is 
recommended that you reboot and issue a Dismount 
command. 


SAV -- ERROR LOGGING STILL ACTIVE 


A system cannot be saved while error logging is 
active. Run the task ERF to disable error logging and 
reissue the Save command. 


SAV -- HOME BLOCK READ ERROR 


The home block of the booted device could not be read. 
Try another drive. If unsuccessful, the disk has been 
corrupted or the area of the home block is bad. This 
error halts the system. 


4-176 


SAV 


SAV 


SAV 


SAV 


SAV 


SAV 


SAV 


SAV 


MCR COMMANDS 


SAV (Cont.) 


INDEX FILE HEADER CHECKSUM ERROR 


While rebooting a saved system, Save detected a 
checksum error in the file header of the index file. 
The error causes the system to halt. The disk has 
probably been corrupted. 


INDEX FILE HEADER READ ERROR 


While rebooting a saved system, Save detected an error 
in the file header of the index file. The error 
causes the system to halt. 


LABEL BLOCK I/O ERROR 


In attempting to saye the system image, Save wrote the 
transfer address in the label block of the 
system-image file. An error occurred during this 
write attempt. The volume could be corrupted. 


MCR IS NOT INSTALLED 


When a system is booted, Save uses MCR to mount’ the 
system disk. MCR... must be installed using VMR. 


MUST BE RUN FROM TERMINAL CO: 


SAV is not being run from the terminal to which’ the 
pseudo device CO: is redirected. This is not a 
requirement on an RSX-11M-PLUS system; therefore, the 
message does not apply. 


NOT VALID SAVE DEVICE 


An attempt was made to save a system on a device’ that 
is not part of the system I/O data structures (this 
generally implies that $SYSIZ + 2 and S$SYSIZ + 6 are 
corrupted), or Save does not support the system 
device, 


OPEN FILE(S) ON ddnn: 


There are open files on ddnn:. Insure that the queue 
manager is stopped. 


PARTITION parname NOT IN SYSTEM, TASK REMOVED - taskname 


This is an RSX-11M error message. If a task is 
installed in more than one system, the partition 
control block addresses in its header mapping windows 
may not be for the booted system. The task's label 
block indicates that the task maps to parname, but 
parname is not in the current system. The label block 
has probably been corrupted. 
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SAV -- SYSTEM MAY NOT BOOT CORRECTLY 


The file [system uic]SAV.TSK was not found on the boot 
device, If SAV must be checkpointed in order to 
redirect and mount the booted device, the system disk 
will be overwritten, causing unpredictable results. 


SAV -- SYSTEM MAY NOT WORK - LARGER THAN MAIN MEMORY 


This message indicates that the booted system has less 
Main memory than the saved system image file and that 
a structure resident in the system image file is 
completely or partially absent in the booted system. 
If the system can run without the structure, Unload 
and Unfix commands can be used to remove the 
nonexistent structures, 


SAV -- SSYSIZ DOES NOT POINT AT SYSTEM IMAGE FILE 


Save determines the location of the system image file 
on the system disk by examining the locations near the 
Executive label SSyYSIZ. Save then makes’ several 
validation checks on that file. If those checks fail, 
Save does not write to the disk on the assumption that 
it could corrupt the disk by writing to something that 
is not a system image file. The system image or the 
system image file has been corrupted. Examine several 
locations after $SYSIZ and then reboot. 


SAV -- TASK ACTIVE IN ANOTHER SYSTEM, TASK REMOVED - taskname 


The task is installed in another system as well as in 
the booted system. Since taskname is active and 
mapped to dynamic regions in the other system, it 
cannot be run in the booted system. 


SAV -- TASK FILE DELETED, TASK REMOVED - taskname 
While rebooting a saved system, a file identification 
that appears in the Task Control Block (TCB) could not 
be found in the index file on the boot device. This 
indicates that the file has been deleted. 

SAV -- TASK FILE HEADER ERROR, TASK REMOVED - taskname 


When Save read the task header to restore the LBN of 
the task file, the checksum was bad or there was a 
file number mismatch. Therefore, the task was 
removed. 


SAV -- TASK FILE HEADER READ ERROR, TASK REMOVED - taskname 


Save removed the specified task because it encountered 
a failure while reading the task's file header. 
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TASK HEADER READ ERROR 


Save detected an I/O error while reading in a_ task 
header to write the file identification into the TCB. 
The error causes the system to halt. 


TASK HEADER READ ERROR, TASK REMOVED - taskname 


Save detected an I/O error while reading in ae_ée task 
header to reassign LUNS or to remap’ the mapping 
windows. Therefore, the task was removed. 


TASK HEADER WRITE ERROR, TASK REMOVED - taskname 


When Save attempted to rebind the LUNs of the task or 
to rewrite a mapping window PCB address, Save could 
not successfully rewrite the task header. Therefore, 
the task was removed. 


TASK LABEL BLOCK READ ERROR, TASK REMOVED - taskname 


When Save attempted to rebind the LUNs of a task to 
the current system, the task's label block could not 
be read (the label block contains the static LUN 
assignments). Therefore, the task was removed. 


TASK TOO BIG FOR PARTITION, TASK REMOVED - taskname 


The current CPU has less memory than the system image 
file. This message indicates that the last partition 
has contracted such that the indicated task cannot fit 
into it even if everything else is removed from the 
partition. 


TASK taskname HAS OUTSTANDING I/0 


A system cannot be saved if a task is waiting for I/0 
to complete. ‘ 


TASK taskname IS ACTIVE AND CHECKPOINTED 


You cannot save a system if it contains an active and 
checkpointed task. This restriction prevents a 
possible system crash; if the task was installed in 
another system image fijle, the task image could be 
corrupted when the task was run in the second system. 


TASK taskname IS CONNECTED TO AN INTERRUPT VECTOR 


Disconnect the task from the interrupt vector or abort 
it and retry the Save command. 


TASK taskname NOT INSTALLED FROM AN LB: 
All tasks must be installed from an LB:. Use the TAS 
command and determine which tasks are not. Retry the 


Save command after removing the tasks or installing 
them from an LB:. 
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SAV -- VOLUME STILL MOUNTED ON ddnn: 


The volume on device ddnn: was still mounted when the 
Save command was issued. A system cannot be saved 
with volumes mounted. Dismount the volumes and retry 
the Save command. If necessary, use the MCR Devices 
command to determine which volumes are mounted. 


SAV -- VOLUME STRUCTURE NOT SUPPORTED 


While rebooting a saved system, Save determined from 
the disk's home block that the disk's structure is not 
supported by the current version of RSX-11M/M-PLUS. 
This error causes the system to halt. 


SAV -- (WARNING) NONEXISTENT LUN ASSIGNMENT FOR TASK taskname 


The physical device to which Save was attempting to 
rebind a LUN does not exist in the booted system. 
This condition is resolved if the task performs a 
run-time assignment to the LUN; otherwise, the task 
will encounter an error condition when it attempts’ to 
use the LUN. 


Additional RSX-11M-PLUS Command Error Messages: 
SAV -- BOOTED DEVICE CANNOT BE BROUGHT ONLINE 
There was an error when Save attempted to bring either 
the unit or controller of the booted device online. 
The Executive is corrupted, the device driver does not 
work, or the device does not’ work. There is no 
recovery procedure. 


SAV -- COMMON comname NOT INSTALLED FROM AN LB: 


All checkpointable commons must be installed from an 
LB:. Remove the common and retry the Save command. 


SAV -- DIRECTIVE PARTITION UNFIXED OR NONEXISTENT 


VMR has been used to make the contents of the 
directive partition disappear. Use VMR to restore it. 
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SAV -- PROPER CONTROLLERS AND/OR UNITS ARE NOT OFFLINE 


When a system is saved, all device units and device 
controllers except the TI: of Save and the load 
device must be offline. Use the CON Display command 
to determine which devices are online, and then issue 
a CON OFFLINE ALL command. 


SAV -- SECONDARY POOL HAS DISAPPEARED 


Save attempts to initialize secondary pool during the 
boot process. This message indicates that Save could 
not find the PCB for the secondary pool partition. 


SAV -- SECONDARY POOL IN USE 


Save cannot save a system if necessary pool is in use, 
(Make certain that you have stopped CPU accounting.) 


SAV -- SYSTEM MAY NOT WORK - CORRUPTED FILE FOR COMMON comname 


When Save attempted to convert the file ID for the 
common, Save found that the task image of the 
checkpointable common was corrupted or had been 
deleted. Save altered the system data structures to 
prevent checkpointing of the common into what may now 
be another task image. 


SAV --(WARNING) COULD NOT SIZE BOOTED DEVICE 


Save recognized the device name as a device that it 
should size, but it could not size it. The UCB words 
U.CW2 and U.CW3 for the booted device may incorrectly 
indicate device size. I/O errors may result. The 
system will work properly if the UCB correctly 
indicates the size of the device. 
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SYSTEM SERVICE MESSAGE 


The SSM command inserts text into the error log reports. The command 
places text into an Error Message Buffer (EMB) which the task ERRLOG 
eventually writes to the file ERR.TMP (see the RSX-11M/M-PLUS Error 
Logging Reference Manual). Following initial processing by PSE, SYE 
includes the message in a full error report. 


Each system service message is assigned a sequence number and a banner 
heading as follows: 


KEKKKKKKEKKEKRKKEKEAEKEKEREENTRY Nig FERRER RARER REAR ERRR KEK EREE KR KER 
SYSTEM SERVICE MESSAGE 


LOGGED date and time ON CPx -- CONFIGURATION ENTRY #n. 
HAKKAR KKK RRR EKER AREER IKE REE RE RIKE ERE ERKE RRR EK EKKEEREKEEE 


TASK INITIATING MESSAGE: ...MCR 
THE MESSAGE IS BELOW: 


Format: 

>SSM message 
where message is any text string up to a maximum of 79 characters. 
Example: 

“SSM TESTING VOLUME INTEGRITY ON DKis+ POSSIBLE FORMAT ERRORS, 


Inserts the message into the error log report. The message will 
appear in a full error log report. 
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UNFIX 

The Unfix command frees a fixed task from memory. The effect is to 
allow tasks that have been waiting for the partition in which the task 
resides to compete for the partition. Unfix is the complement of the 
Fix command. 


If a fixed task exits or aborts, it still occupies the physical memory 
of the partition. 


Format: 
UNF[IX] taskname 


where taskname is the name of the task. 


Examples: 


»UNFIX XKE 


Unfixes task XKE, freeing the partition in which it resides 
for task competition. 


UNF FCSRES/REG 
Frees the resident library for FCS from its partition. 
“UNFIX «.+MAC/RON 


Unfixes the read-only segment of the MACRO-11 assembler from 
its partition. 


Command Error Message: 
UNF -- TASK NOT FIXED 


An attempt was made to unfix a task that was not 
fixed. 
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UNLOAD 
The Unload command removes a loadable device driver from memory. If a 
device is mounted, attached, or has outstanding I/0, its driver cannot 
be unloaded. Also, the Unload command cannot remove a data base from 
memory, even if the data base was loaded by means of the Load command. 
To unload a device driver from memory, the driver's STB file must 
reside on the system device (LB:) under the system UIC. The SET 
/SYSUIC command displays and defines the system UIC; but usual values 
are [1,50] for unmapped systems and [1,54] for mapped systems. 
Format: 

UNL[OAD] dd: 

where: 

dd: - A 2=-character ASCII device name 

Example: 


UNL LPs 


Unloads the loadable device driver for device LP:. 


Command Error Messages: 

UNL -- DEVICE ddn: HAS UNITS ATTACHED, BUSY, AND/OR MOUNTED 
An RSX-11M message. Device ddn: is the first or only 
unit that is attached, mounted, and/or has outstanding 
I/O. Therefore, the driver cannot be unloaded. 

UNL -- DEVICE ddn: NOT IN SYSTEM 
No such device existed in the system. 

UNL -- DEVICE NOT MOUNTED 
The system device (LB:) was not mounted. 


UNL -- DRIVER BUILT WITH WRONG EXECUTIVE STB FILE 


The STB file for the driver was not compatible with 
the current Executive. 


UNL -- DRIVER CANNOT BE UNLOADED 
The Unload command attempted to remove a permanently 
resident device driver (that is, a driver linked to 
the Executive). 


UNL -- DRIVER NOT LOADED 


The device driver specified in the Unload command was 
not resident in memory. 
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UNL -- FILE filename HAS ILLEGAL STB FORMAT 
The driver's STB file contained illegal object code or 
data. 

UNL -- ILLEGAL VALUE FOR SYMBOL symname IN FILE filename 


The symbol symname is defined to an illegal vaiue by 
the file ddDRV.STB. Since ddDRV.STB had to pass 
inspection by LOA, there probably has been a 
procedural error or ddDRV.STB has been corrupted. 


UNL -- LOADABLE DRIVER SUPPORT NOT IN SYSTEM 


An RSX-11M message. The system generation option to 
support loadable device drivers was not chosen. 


UNL -- SYMBOL symname IS DOUBLY DEFINED BY FILE filename 
The symbol symname was found in the file ddDRV.STB, 
but it was not a symbol definition. Since ddDRV.STB 
had to pass inspection by LOA, there probably has been 
a procedural error or ddDRV.STB has been corrupted. 
UNL -- SYMBOL symname IS UNDEFINED BY FILE filename 
The symbol symname was found in the file ddDRV.STB, 
but it was not a symbol definition. Since ddDRV.STB 
had to pass inspection by LOA, there probably has been 
a procedural error or ddDRV.STB has been corrupted. 
Additional RSX-11M-PLUS Error Messages 


UNL -- DEVICE ddn: IS ATTACHED, BUSY, ONLINE AND/OR MOUNTED 


Device ddn: is the first or only unit that is 
attached, online, mounted, and/or has outstanding I/0. 
Therefore, the driver cannot be unloaded. 
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INDIRECT COMMAND FILES 


This chapter describes indirect command files and how to use’ them. 
The sections that follow describe the MCR indirect command file 
Processor and its components and then define all the processor 
directives that control the execution of an MCR indirect command file. 


5.1 INTRODUCTION 


An indirect command file is a text file containing a series of 
commands exclusive to, and interpretable by, a single task. The 
interpreting task is usually a system-supplied component of 
RSX~11M/M-PLUS, such as MCR, MACRO-11, or the Task Builder. 


There are two types of indirect command files: indirect task command 
files and indirect MCR command files. 


An indirect task command file is a sequential file containing a list 
of task specific commands. Rather than typing commonly used sequences 
of commands, you can type the sequence once and store it in a file. 
The indirect task command file is specified in place of the command 
line(s) normally submitted to the task. 


To initiate indirect task command files, replace the command. string 
for a task with a file specifier, preceded by an at sign (@). The 
task requesting input then accesses the specified file and starts to 
read and respond to the commands contained within it. For example, to 
initiate a file of MACRO-11 commands, input the following: 


*MAC @INPT.CMD 


The MACRO-11 Assembler accesses the file and then executes’. the 
commands contained within the file INPT.CMD. 


An indirect MCR command file contains a list of MCR commands. In 
addition, an indirect MCR command file can contain special commands 
that allow you to control command file processing (see Section 5.2). 
To initiate an indirect MCR command file, enter the file specifier, 
preceded by an at sign (@), whenever MCR can accept input. For 
example: 

“@MCRIPT.CMD 


The default file type for indirect command files is .CMD. Thus’ the 
above command line could also be input as follows: 


“@MCRIPT 


INDIRECT COMMAND FILES 


An indirect file can contain any command that can be interpreted by 
the task to which it is directed. 


Some tasks, including MCR, allow nested command files (one command 
file invokes another). See the appropriate task documentation for the 
maximum nesting depth allowed. 


When the processor reaches the end of the highest level file, it 
displays the message 


s@ <EOF> 
and then exits. 


To exit the indirect command file processor (AT.) prematurely, type 
in response to any request for input from the indirect file 
processor. The message 


*@ EOF ® 


is then displayed. 


5.2 MCR INDIRECT FILE PROCESSOR 


Most tasks read and respond to commands contained in an indirect file 
as if the commands were entered directly froma terminal. MCR, 
however, has an indirect file processor for interpreting commands from 
a file. An MCR indirect command file can contain both normal MCR 
commands and special commands (known as directives) to be interpreted 
by the indirect file processor itself. 


When processing an indirect command file, AT. first reads the command 
file and interprets each command line either as a command to be passed 
directly to MCR or as a request for action by the indirect command 
file processor itself. The directives to AT. are distinguished by a 
period (.) as the first character in the line. MCR commands have no 
special prefix characters. 


The directives to AT. form a procedural language, which allows you 
to: 


1. Define labels 


2. Define and assign values to symbols of three types: logical, 
numeric, and string 


3. Create and access data files 

4. Control the logical flow within a command file 

5. Perform logical tests 

6. Enable or disable any of six operating modes 

7. %Q Increment or decrement a numeric symbol 

8. Control time-based and parallel task execution 
Two directives (.BEGIN and .END) permit you to block structure the 
command file and create Begin-End blocks. Modular, block structured 


command files are easier to debug and maintain. More importantly, 
Begin-End blocks isolate local symbol definitions as well as labels 


INDIRECT COMMAND FILES 


and thus conserve symbol table space. When you define a symbol, the 
indirect command file processor creates an entry in an internal symbol 
table. These symbol table entries retain their definitions throughout 
the command file execution if defined locally, or throughout all 
levels of command files if defined globally. Local symbols defined 
within a block, however, are defined only within that block; they are 
erased from the symbol table when AT. encounters an .END directive. 


MCR displays on the requesting terminal every MCR command executed. 
However, if AT. is activated by @filename/-MCR, MCR commands in the 
indirect file are converted to comments with a leading exclamation 
point (!); the MCR commands are displayed, but not executed. 


An MCR indirect file can also include comments, which the processor 
prints at the requesting terminal. Comments that begin a line 
interpreted by MCR have a leading semicolon (;). (The semicolon can 
be preceded on the same line by a directive to the indirect 
processor.) Comments that appear after the start of an MCR _ command 
have a leading exclamation point (!). All lines in an indirect 
command file that begin with a period followed by a semicolon (.;) are 
treated as comments, but are not displayed when the file is processed. 


The indirect command file processor attaches the terminal while 
processing contiguous comment lines (only comments beginning with ;, 
not !). This permits you to type and suppress a_ lengthy 
comment. Output is resumed by typing another or is resumed at 
the next MCR command in the command file. 


The AT. directives described in this chapter are listed below by 
category. A detailed description of each directive is presented in 
alphabetical order in Section 5.6. 

Label Definition 


»label: Assigns a name to a line in the command file 
so that the line may be referenced. 


Symbol Definition 


~ ASK Defines or redefines a logical symbol and 
assigns the symbol a logical (true or false) 
value. 

-ASKN Defines or redefines a numeric symbol and 
assigns the symbol a variable value. 

-ASKS Defines or redefines a string symbol and 
assigns the string symbol a variable ASCII 
value. 

- ERASE Deletes local or global symbol definitions. 

»SETT/.SETF Defines or redefines a logical symbol and 


assigns the symbol a true/false value. 


»~SETN Defines or redefines a numeric symbol and 
assigns the symbol a numeric value. 


~SETS Defines or redefines a string symbol and 
assigns the symbol a character string value. 


val 


File Access 


-DATA 


«CHAIN 


»CLOSE 


-OPEN 


~OPENA 


Logical Control 
-~BEGIN 
-END 


«EXIT 


-GOSUB 


«GOTO 


-ONERR 


-RETURN 


- STOP 


Logical Tests 


IF 


-IFACT/.IFNACT 


~IFDF/.IFNDF 


- IFINS/.IFNINS 


- IFLOA/.IFNLOA 


-ITFT/.IFF 


TEST 
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Specifies a single line of data to output to 
an output data file. 


Closes the current indirect file and uses 
commands from another file. 


Closes an output data file. 

Creates and opens an output data file (if the 
file exists, creates a new version and opens 
it). 


Opens an existing file and appends subsequent 
data (does not create a new version). 


Marks the beginning of a Begin-End block. 
Marks the end of a Begin-End block. 
Terminates processing of either a Begin-End 
block or the current command file, returns 
control to the previous level, and optionally 
sets special symbol <EXSTAT> value, 


Branches to a label identifying a subroutine 
within the command file. 


Branches to a label within the command file. 


Branches to a label upon detecting a specific 
AT. error condition. 


Effects an exit from a subroutine and returns 
to the line immediately following the 
subroutine call. 


Terminates indirect command file processing 
and optionally sets AT. exit status. 


Determines whether or not a symbol satisfies 
one of several possible conditions. 


Determines whether or not a task is active. 


Determines whether or not a symbol is 
defined. 


Determines whether or not a task is installed 
in the system, 


Determines whether or not a device driver is 
loaded. 


Determines whether a logical symbol is true 
or false. 


Tests the length of a string symbol. 
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Enable/Disable An Operating Mode 


»~DISABLE Disables substitution, data, global symbols, 
lower-case option, escape recognition, or 
echo control. 


» ENABLE Enables substitution, data, global symbols, 
lower-case option, escape recognition, or 
echo control. 


Increment/Decrement Numeric Symbols 


»DEC Decrements the value of a numeric symbol by 
one. 

~ INC Increments the value of a numeric symbol by 
one. 


Execution Control 


« DELAY Delays the execution of an indirect command 
file for a specified period of time. 


» PAUSE Stops the indirect command file processor and 
allow user action. 

»WAIT Waits for a specified task to complete 
execution. 

~XQOT Initiates a task, pass a command line to it, 


and continue indirect command file processing 
without waiting for the task to complete 


5.3 SYMBOLS 


The MCR indirect file processor enables you to define symbols. These 
symbols can then be tested or compared in order to control flow 
through the indirect command file. They may also be substituted for 
MCR commands, data records for data files, or comments to be displayed 
on the terminal. 


Symbol names are ASCII strings from 1 to 6 characters in length. They 
must start with a letter (A-Z) or a dollar sign ($). The remaining 
characters must be alphanumeric or §. 


There are three symbol types: 
e Logical 
e String 
e Numeric 


A logical symbol has either a true or false value. 


A string symbol has as its value a string of ASCII characters, with a 
length between 0 and 80(10) characters inclusive. 


A numeric symbol can have a numeric value in the range of 0-65535(10) 
inclusive. The symbol can be defined to have either a decimal or 
octal symbol value. The value (decimal or octal) is relevant only 
when the symbol is substituted (see Section 5.3.2). 
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A symbol's type (logical, numeric, or string) is defined by the first 
assignment directive that assigns a value to the symbol. Subsequent 
assignments may assign a different value, but cannot redefine’ the 
symbol type. Assignment directives can assign: 


e A true or false value to define a logical symbol 
(Defined by .ASK, .SETT or .SETF.) 


e An octal or decimal number to define a numeric symbol 
(Defined by .ASKN or .SETN.) 


e A character string to define a string symbol 
(Defined by .ASKS or .SETS.) 


5.3.1 Special Symbols 


The MCR indirect command file processor automatically defines special 
symbols dependent upon specific system characteristics and the replies 
to queries presented during command file execution. As with symbols, 
special symbols can be compared, tested, or substituted and have three 
types: logical, numeric, and string. All special symbols have a 
common format; angle brackets (<>) enclose the special symbol name. 


5.3.1.1 Special Logical Symbols - The special logical symbols are 
assigned a true or false value under the following circumstances. 


Symbol Value 

<ESCAPE> Set to true if last query was answered with a_ single 
escape character. Otherwise, <ESCAPE> is set to 
false. 

<DEFAUL> Set to true if answer to last numeric query (.ASKN) 


was defaulted (a single carriage return was entered). 


<AL PHAN > Set to true if last string entered in response to an 
-ASKS directive or tested with a .TEST directive 
contains only alphanumeric’ characters. An empty 
string also sets <ALPHAN> true. Note that a 
lowercase response to a query when lowercase is 
disabled sets <ALPHAN> false. 


<RAD5 0> Set to true if last string entered in response to an 
-ASKS directive or tested with a .TEST directive 
contains only Radix-50 characters. Radix-50 


characters are the alphanumeric characters plus 
period (.) and dollar ($). A blank is not a Radix-50 
character in this context. An empty string also sets 
<RAD50> true. 


<MAP PED> Set to true if the system on which AT. is running is 
mapped, false if the system is unmapped. Always true 
in an RSX-11M-PLUS system. 


<RSX11D> Always false in an RSX-11M/M-PLUS system. 
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5.3.1.2 Special Numeric Symbols - The following values are assigned 
to the, special numeric symbols. 


——s 


Symbol Value 

<MEMS IZ> Assigned the value of the current system memory size 
in K words. 

<SYUNIT> Assigned the unit number of the user's default device 
(SYs). 

<EXSTAT> Assigned the value of 0, 1, 2, or 4 depending on the 


exit status from the last MCR command executed or 
from the last .WAIT tskname directive where tskname 
was activated by the .XQT directive. 


This special numeric symbol is modified at the 
completion of a synchronous MCR command or at the 
5 : completion of a .WAIT directive. The .EXIT directive 
ww can also modify <EXSTAT>. The value is returned from 
the task that has completed if the task exits with 
status. Otherwise, the value is returned from MCR. 
The values 0, 1, 2, and 4 indicate: 


0 Warning 
1 Success 
2 Error 
4 Severe error 
<STRLEN> Assigned the length of the string entered in response 
: to the last .ASKS directive or the string tested by 
“eww” the last .TEST directive. 


<SPACE> Assigned the number, in octal, of free bytes in the 
internal symbol table of AT.. 


<SYSTEM> Assigned an octal number to represent the operating 
system on which AT. is running. The value 1 is for 
an RSX-11M system, the value 6 is for an RSX~11M-PLUS 
system. 


w 5.3.1.3 Special String Symbols - The special string symbols are 
assigned the following string values. 


Symbol Value 

<CLI> Assigned the acronym (three letters) of the current 
Command Language Interpreter (DCL or MCR); format is 
MCR. 

<DATE> Assigned the current date; format is dd-mon-yr. 

<LIBUIC> Assigned the UIC of the current nonprivileged task 


library; format is [ggg,mmm] 


<SYDISK> Assigned the device mnemonic (two letters) of the 
user's default device (SY:); format is DK. 
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Symbol Value 

<SYSUIC> Assigned the system UIC; format is [ggg,mmm]. 
<TIME> Assigned the current time; format is hr:min:sec. 
<UIC> Assigned the current UIC; format is [ggg,mmm] 


5.3.2 Symbol Value Substitution 


Substitution can occur in any line of a command file. Indirect MCR 
commands can use the values assigned to logical, numeric, string, or 
special symbols by replacing a normal parameter (for example, a 
device-unit) with the symbol name enclosed in apostrophes (for 
example, 'DEV'). When a previous directive has enabled substitution 
mode (.ENABLE SUBSTITUTION), AT. replaces the symbol name enclosed in 
apostrophes with the value assigned to the symbol. 


When AT. encounters an apostrophe, it treats the subsequent text, up 
until a second apostrophe, as a symbol name. AT. then searches the 
table of symbols for the corresponding symbol, and substitutes’ the 
value of the symbol in the indirect command line in place of the 
symbol name and surrounding apostrophes. 


For example, the first three lines below appear in an indirect command 
file. When the processor executes these lines, it displays the last 
two lines at the entering terminal. 


«ASKS DEV MOUNT ON DEVICE? : 
-ENABLE SUBSTITUTION 
MOUNT 'DEV' 


**® MOUNT ON DEVICE? [S1: Dk2: 
MOUNT DK2s 


DK2: was entered in response to the displayed question. This reply 
assigned the string value DK2: to string symbol DEV. Then when the 
indirect file processor read: 


MOUNT 'DEV' 


it substituted for 'DEV' the value assigned to DEV, that is, DK2:. If 
substitution mode was not enabled, the processor would simply have 
passed the line to MCR as it appeared in the command file (that is, 
MOUNT 'DEV'). 


If substitution mode is enabled, an apostrophe signals the beginning 
of a string symbol. Thus, to include a single quote as text within a 
command line, rather than as the start of a symbol, you must’ replace 
the single quote with two contiguous apostrophes (''). 


If substitution mode is enabled, the processor displays the command 
file line 


! DON''T SHOOT 


as 


' DON’T SHOOT 
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5.3.3 Numeric And String Symbols 


The MCR indirect command file processor assigns a value, either 
numeric or string, to symbols. This assignment defines the symbol as 
either a numeric symbol or a string symbol. 


5.3.3.1 Numeric Symbols And Expressions - A numeric symbol is a 
string of digits representing a value in the range of 0-177777 octal 
(0-65535 decimal if immediately followed by a period). If an 
arithmetic operation yields a result outside of this range, a fatal 
error occurs and the message 


AT. --NUMERIC UNDER ~ OR OVERFLOW 
is displayed. 


When a numeric symbol is substituted into a string, the type (octal or 
decimal) is determined by the value assigned via an .ASKN or .SETN 
directive. 


A numeric symbol or constant may be combined with another numeric 
symbol or constant by a logical or arithmetic operator to form a 
numeric expression. Arithmetic operators are used to add (t+), 
subtract (-), multiply (*), and divide (/). Logical operators are the 
inclusive OR (!) and logical AND (&). No embedded blanks or tabs are 
permitted between operators. 


Numeric expressions are evaluated from left to right unless 
parentheses are used to form subexpressions that are evaluated first. 
For example, the directive lines: 


-SETN N1 2 
-SETN N2 3 
~SETN N3 N1+N2*4 


assigns numeric symbol N3 the value 24 octal whereas the directive 
lines 


-SETN Nl 2 
~-SETN N2 3 
-SETN N3 N1+(N2*4) : 
assigns numeric symbol N3 the value 16 octal. 


The type of an expression is octal if all the operands are octal; 
otherwise the type is decimal. 


For example, the directive lines: 
-SETN Nl 2 
~SETN N2 3 
~SETN N3 N1+N2*4. 


assigns numeric symbol N3 the decimal value 20. 
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Numeric expressions are permitted as second operands in numeric .IF 
and .SETN directives. They are also permitted as range and default 
arguments in .ASKN and .ASKS directives. The directives .EXIT and 
-STOP permit numeric expressions to represent exit status. 


5.3.3.2 String Symbols, Substrings, And Expressions - A string 
constant is a string of any printable characters enclosed by quotes 
("). Empty strings are also permitted. The number of characters 
cannot exceed 80. 


Examples: 


"ABCDEF" 


String symbols may have a value of any string constant. The value is 
assigned by a .SETS or .ASKS directive. For example, the directive 
lines 


-SETS Sl "ABCDEF" 
-SETS $2 sl 


assigns string symbol S2 the value of string symbol Sl (that is, 
ABCDEF). 


A substring facilitates the extraction of a segment from the value of 
a string symbol. You can use substrings only as second operands in 
-SETS and .IF directives. For example, the directive lines 


-SETS Sl "ABCDEF" 
-SETS 52 $1[1:3] 


assign string symbol S2 the value of string symbol Sl beginning at 
character one and ending at character three (that is, ABC). 


You can combine a string constant, symbol, or substring with another 


string constant, symbol, or substring by the string concatenation 
operator (+) to form a string expression. 


String expressions are permitted as second operands in .SETS and .IF 
directives where the first operand is a string symbol. For example, 
the directive lines 


-SETS Sl "A" 
~SETS S2 "CDEF" 
-SETS $3 S1+"B"4+S2 [1:3] 


assign string symbol S3 the value of the concatenation of string 


symbol Sl, string constant "B", and the first three characters of 
string symbol S2 (that is, ABCDE). 


5.4 SWITCHES 


The indirect file processor accepts three switches: /TR, /DE, and 
/MC. 
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Switch Function 
7/TR Displays a trace of each processed line on the entering 
terminal. This function is useful for debugging an 


indirect command file. Each command line, including 
those that begin with a period (directive), is 
displayed. The period on the first directive in the 
line is changed to an exclamation point (comment) and 
displayed. If the command causes some action to occur, 
the next printed line indicates the action; usually, 
this line consists of the MCR commands issued as a 
result of the previous directive. 


/DE Indicates that the indirect command file is to be 
deleted when processing is complete. 


/MC Indicates that commands are to be passed to MCR. 
Use any combination of the switches in the command 
@filename /switches 
or directive 
CHAIN filename /switches 


To negate the action of the switch, prefix it with a minus sign (-) or 
"NO" (for example, /NOMC suppresses sending of commands). The 
defaults are /NOTR, /NODE, and /MC. 


The switches you specify in the terminal command that initiates 
indirect processing are used as defaults when executing the commands 
filename [/switches] or .CHAIN filename[/switches]. This does not 
apply, however, for the /DE switch; the default is always /NODE. 


5.5 MULTI-LEVEL INDIRECT FILES 


You can specify up to four levels of MCR indirect command files. A 
processor directive (.ENABLE GLOBAL) allows the definition of some 
symbols as global to all indirect file levels (see Section 5.6.12). 
Otherwise, each time the processor enters a deeper level, it masks all 
symbols defined by the previous level out of the symbol table, so that 
only symbols defined in the current level are available. These 
symbols are local only to the level of command file in which they are 
defined. When control returns to a previous’ level, the symbols 
defined in that level become available once again and the ones from 
the lower level are lost. 


5.6 DIRECTIVES 


Directives must be separated from their arguments and from MCR 
commands by at least one space. 
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You can insert any number of blanks and horizontal tabs in three 
places of a command line: 


e At the start of the command line 
e Immediately following the colon (:) of a label 
e At the end of the command line 


This allows you to format the command files for readability. The 
recommended procedure is to begin labels in column one and everything 
else in column nine (after one horizontal tab). 


An important exception is the lines processed between .ENABLE and 
»DISABLE DATA directives; no blanks or tabs are removed from these 
lines. For example: 


-IFT Z .GOTO 10 
MAC @ASM 
10: TKB @BLD 
OPEN DATFIL 
DATA XXXXX 
«ENABLE DATA 
THIS IS DATA 
THAT GOES INTO 
THE DATA FILE 
«DISABLE DATA 
-GOTO 20 


5.6.1 Define A Label -label: 


Labels always appear at the beginning of the line; they may be on a 
line with additional directives and/or an MCR command, on a line with 
a comment, or on a line by themselves. When control passes to a_ line 
with a label, the line is processed from the first character after the 
colon. 


Commands do not have to be separated from the label by a space. Only 
one label is permitted per line. Labels are 1 to 6 characters long, 
and must be preceded by a period and terminated by a colon. A label 
may contain only alphanumeric characters and/or dollar sign (S$). 


It is also possible to define a label as a direct access label; once 
the label is found, its position in the command file is saved. This 
allows subsequent jumps to frequently called labels or subroutines’ to 
be effected very quickly. The first statement processed after a jump 
to a direct access label is the one on the next line. You can define 
up to 20(10) direct access labels within an indirect command file. If 
you define more than 20, the subsequent direct access labels’ replace 
the earliest and so on. 
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To declare a label as direct access, leave the line following the 
colon blank. 


Examples: 
100: »-ASK A DO YOU WANT TO CONTINUE? 


-IFT A -GOSUB 200 


-200; 


7THIS IS THE START OF A SUBROUTINE 


»RETURN 


5.6.2 Ask A Question And Wait For A Reply - ASK 


The .ASK directive prints a question on the terminal, waits for a 
reply, and sets a specified logical symbol to the value of true or 
false, depending on the reply. If the symbol has not already been 
defined, the processor makes an entry in the symbol table. If the 
symbol has been defined, the processor resets its value (true or 
false) in accordance with the reply. The processor exits with a fatal 
error if the symbol was previously defined as a string or numeric 
symbol. 


Format: 


-ASK ssssss txt-strng 


where: 
ssssss = 1- to 6-character symbol to be assigned a 
true/false value. 
txt-strng = any ASCII string of characters, preceded by at 


least one blank. The maximum length of 
txt-strng is 70. 


When executing an .ASK directive, the processor displays txt-strng 
prefixed by an asterisk and suffixed with "? [Y/N]:". The processor 
recognizes four answers: 


1. YCerT) - set symbol ssssss to true. 
2. NC) - set symbol ssssss to false. 


3. Cat) - set symbol to false. <CR> indicates carriage return. 
4. Cec) - set symbol ssssss to true and set the special logical 


symbol <ESCAPE> to true only if escape recognition has been 
enabled. (sc). indicates escape or altmode. 
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Example: 
The directive line 

-ASK INSPIP DO YOU WANT TO INSTALL PIP 
displays 

s* DO YOU WANT TO INSTALL PIP? [Y/N1: 


on the terminal. Symbol INSPIP will be set to true or false after the 
user types Y, N, Cer), or (if escape recognition is enabled). 


5.6.3 Ask For Definition Of A Numeric Symbol ~ASKN 


The .ASKN directive prints on the terminal a request for a numeric 
value, waits for it to be entered, optionally tests the range of the 
numeric response and/or applies a default value, and sets’ the 
specified symbol accordingly. If the symbol has not previously been 
defined, the processor makes an entry in the symbol table. If the 
symbol has already been defined, the processor resets its value in 
accordance with the reply. The processor exits with a fatal error if 
the symbol was previously defined as a logical or string symbol. 


Format: 


-ASKN ssssss txt-strng 
-ASKN[low:high] ssssss txt-strng 
~-ASKN[::def] ssssss txt-strng 
-ASKN{low:high:def] ssssss txt-strny 
(Brackets are required syntax) 


where: 

ssssss =1- to 6-character symbol to be assigned a 
numeric value. 

txt-strng = any ASCII string of characters, preceded by at 
least one blank. txt-strng is the text 
displayed by the indirect file processor. The 
maximum length of txt-strng is 70. 

low:high = the inclusive limits for the response. 

def = the default value. 


The range and default arguments permit you to combine numeric symbols 
or constants with another numeric symbol or constant to form a numeric 
expression (see Section 5.3.3.1). 


The command line cannot exceed 80 characters in length. When 
executing an .ASKN directive, the processor displays txt-strng 
prefixed by an asterisk and suffixed with [0]: to indicate that the 
response is considered as octal or [D]: to indicate that the response 
is considered as decimal. The reply must be a number either within 


the specified range or in the range 0-177777 octal by default, 0-65535 
decimal. 


If the response is outside the specified range, the message 
AT, -- VALUE NOT IN RANGE 


is displayed and the query repeated. 


5-14 
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If an arithmetic operation yields a result greater than 177777(8) when 
computing the actual value of any of the arguments low, high, or 
default, a fatal error occurs and the message 

AT. -- NUMERIC UNDER- OR OVER-FLOW 
is displayed. 
If the response is an empty .line (null) and a default value (def) was 
not specified, the processor applies a default of 0. Note that in 
this case, the range, if specified, must include 0. 
The response may be either octal or decimal; a leading pound sign (#) 
forces octal, a trailing period (.) forces decimal. In the absence of 
both, the processor applies a default type. The default type is 
decimal if either the range or default values are decimal expressions 
(followed by a period). Otherwise, the default type is octal. AT. 
displays the default type as either [0] or [D]. 


To force a decimal default type without specifying a range argument, 
use the following construction: 


»ASKN [::0.] A ENTER VALUE 
When a numeric symbol is substituted into a string, AT. determines 
the type (octal or decimal) by the assigned value. The type of the 
source value is then copied to the destination symbol. 
Examples: 
The directive line 
-ASKN SYM DEFINE NUMERIC SYMBOL A 
displays 
**¥DEFINE NUMERIC SYMBOL A [Q]: 
on the entering terminal where: 
[0] = the default type (octal). 
The processor then defines symbol SYM according to the reply entered. 
The directive line 
»-ASKN [2:35:16] NUMSYM DEFINE NUMERIC SYMBOL A 
displays 
“% DEFINE NUMERIC SYMBOL A [CO Ri2-35 DriBls 
in the format [x R:low-high D:def] 


where: 


O if the default radix is octal, or D if it is 
decimal. 


xX 


R: low-high the specified range. 


D: def 


the specified default. 
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The processor then checks that the response string is within the 
specified inclusive range. 
The directive line 
eASKN [NUMSYM+10:45:NUMSYM+10] SYM DEFINE NUMERIC SYMBOL B 
displays (assuming the default value of 16 for NUMSYM) 


>* DEFINE NUMERIC SYMBOL B [CO R:2G-45 D:261]: 


5.6.4 Ask For Definition Of A String Symbol ~ASKS 


THE .ASKS directive prints on the terminal a request for a _ string 
value to define a specified symbol, and optionally tests that the 
number of characters in the response string falls within the specified 
inclusive range. If the symbol has not previously been defined, the 
processor makes an entry in the symbol table. If the symbol has 
already been defined, the processor resets its value in accordance 
with the reply. The processor exits with a fatal error if the symbol 
was defined previously as a logical or numeric symbol, If the number 
of characters is out of the specified range, the message 


AT. -- STRING LENGTH NOT IN RANGE 
is displayed and the query repeated. 
Formats: 

ASKS ssssss txt-strng 


-ASKS [low:high] ssssss txt-strng 
(Brackets are required syntax) 


where: 

ssssss = 1- to 6-character symbol to be assigned a string 
value. 

txt-strng = any ASCII string of characters, preceded by at 
least one blank. txt-strng is the text 
displayed by the indirect file processor. The 
maximum length of txt-strng is 70. 

low:high = the inclusive limits for the number of 


characters permitted in the response string. 
The command line cannot exceed 80 characters in length. 


When specifying range arguments, you may combine numeric symbols’ or 
constants with another numeric symbol or constant to form a numeric 
expression (see Section 5.3.3.1). 


When executing an .ASKS directive, the processor displays txt-strng 
prefixed by an asterisk (*) and suffixes it with [S]:. The reply must 
be an ASCII character string. 
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Examples: 
The directive line 

»~ASKS NAM PLEASE ENTER YOUR NAME 
displays 

»* PLEASE ENTER YOUR NAME ES]: 


on the entering terminal. The processor then defines symbol NAM 
according to the string reply entered. 


The directive line 

-ASKS [1:15] MIDNAM PLEASE ENTER YOUR MIDDLE NAME 
displays 

>* PLEASE ENTER YOUR MIDDLE NAME £S Ril~151: 
in the format [S R:low-high] 


where: 


S the symbol type (string). 


R: low-high 


the specified range for number of characters. 


5.6.5 Begin Block BEGIN 


The .BEGIN directive marks the beginning of a Begin-End block. All 
local symbols following the directive are local to the block instead 
of the entire command file. An .ERASE LOCAL directive (see Section 
5.6.14) erases all local symbols within the block. 


Begin-End blocks can be nested up to a maximum depth of 127. AT. 
usually exhausts stack space before this limit can be reached; you 
may wish to rebuild AT. and specify more task stack space if an 
application requires the maximum nesting level. 


Format: 
» BEGIN 


~BEGIN must be the only directive ona line, The .BEGIN directive 
cannot appear, for example, on the same line as an .IF directive. 


Begin-End blocks isolate local symbol definitions and _ labels. All 
local symbols defined inside a block lose definition outside the 
block. However, all symbols defined outside a block retain definition 
throughout the command file. Note that symbols defined outside a 
block and then modified within a block assume and retain the value 
assigned in the block. 


The block must be terminated by an .END directive. 
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5.6.6 Continue Processing Using Another File - CHAIN 
The .CHAIN directive closes the current indirect file, masks all local 
symbols, and continues processing using commands fetched from another 
file. However, the .CHAIN directive does not close data files or 
change the file indirection level. 
Format: 

-CHAIN filename [/switches] 
where filename is the name of the file that contains the new commands 
and /switches are any of the optional switches described in Section 
5.4. 
Example: 
The directive 


-CHAIN OUTPUT 


transfers control to the file OUTPUT.CMD. 


5.6.7 Close Secondary File - CLOSE 


The .CLOSE directive closes the secondary file opened by an _ .OPEN 
directive. 


Format: 


-CLOSE [#n] 
(Brackets not part of syntax.) 


where: 
#n = optional file number in the range 0-3 inclusive. 
Default is #0. You can substitute a numeric 
symbol for the value n by enclosing the symbol in 
apostrophes. 
5.6.8 Output Data To Secondary File -DATA 


The .DATA directive specifies text that is to be output to a secondary 
file previously opened by an .OPEN directive. 


Format: 


»DATA [#N] text-string 
(Brackets not part of syntax.) 


where: 


text-string text to be output to the secondary file. 

#N = optional file number in the range 0-3 
inclusive. Default is 0. You can substitute 
a numeric symbol for the value N by including 
single quotes. 
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The command line cannot exceed 80 characters. (The specified text 
cannot continue onto the next line.) If a secondary file is not open, 
an error condition exists; the indirect file processor issues an 
error message and begins error processing. 


Example: 


-SETS SEND "THIS IS DATA" 


»~OPEN TEMP 
»DATA 'SEND' 
»- CLOSE 


These directives output THIS IS DATA to the secondary file TEMP.DAT. 


5.6.9 Decrement Numeric Symbol -DEC 
The ,DEC directive decrements a numeric symbol by 1. The processor 
exits with a fatal error if the symbol was defined previously as a 
logical or string symbol. 
Formats: 

»-DEC ssssss 

where: 

ssssss = l- to 6-character numeric symbol. 

Example: 


~-DEC N 


This directive decrements by 1 the value assigned to the numeric 
symbol N. 


5.6.10 Delay Execution For A Specified Period Of Time . DELAY 


The .DELAY directive delays further processing of the indirect file 
for a specified period of time. 


Format: 
»~DELAY nnu 
where: 
nn = Number of time units to delay. 
u = T - ticks 


S - seconds 
M - minutes 
H - hours 


The parameter nn is octal by default, or decimal if terminated with a 
period. For example: 


10S is 10(8) seconds 
10.S is 10(10) seconds 


When the DELAY directive is executed, the processor issues the message 


AT. -- DELAYING 
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When the time period expires and the task resumes, the processor 
issues the message 
AT. -- CONTINUING 
Example: . 
The directive 
»~DELAY 20M 


delays processing for 20(8), or 16(10) minutes. 


5.6.11 Disable Option » DISABLE 
The .DISABLE directive disables a specified operating mode 
(substitution, data, global symbol, lower-case, escape recognition, or 
echo control) previously activated by an .ENABLE directive. See 
Enable Option (Section 5.6.12) for operating mode information. 
Formats: 


~DISABLE SUBSTITUTION 


-DISABLE DATA [#n]} 
(Brackets not part of syntax.) 


where: 
#n = optional file number in the range 0-3. Default is 0. 
You can substitute a numeric symbol for the value n by 
enclosing the symbol in apostrophes. 
»-DISABLE GLOBAL 
»~DISABLE LOWERCASE 
»~DISABLE ESCAPE 


-DISABLE QUIET 


5.6.12 Enable Option - ENABLE 


The .ENABLE directive is used to invoke one of six operating modes: 
lower to upper-case character conversion; data mode; global symbol 
mode; substitution mode; recognition of an escape character; or 
echo control. Each mode is independent of the others; all six can be 
active simultaneously. When the indirect file processor starts to 
process a command file, the initial settings are: 


Lower case enabled 
Data disabled 
Global disabled 
Substitution disabled 
Escape disabled 
Quiet disabled 


In lower-case mode, characters read from the terminal in response’ to 
-ASKS directives are stored in the string symbol without lower- to 
upper-case conversion. The representation of characters is 
significant when comparing strings (see Section 5.6.18) since the .IF 
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directive treats lower-case and upper-case characters as distinct. 
Also, note that if lower-case mode is disabled and the response to a 
guery is in lower-case, the special logical symbol <ALPHAN> is set to 
false. 


In data mode, the processor outputs lings that follow the directive 
line .ENABLE DATA to a secondary file. (The .DATA directive sends a 
single line of text to a secondary file; see Section 5.6.8.) 


In global symbol mode, symbol names that begin with a dollar sign (S$) 
are defined as global to all levels of indirect files; once such a 
symbol has been defined, all levéls recognize it. Symbols that do not 
begin with a dollar sign are always recognized only by the level that 
defines them. 


In substitution mode, the processor substitutes a string in place of a 
symbol. The symbol must begin and end in apostrophes ('SYMBOL'). For 
example, if the symbol A has been assigned the string value THIS IS A 
TEST, then every A will be replaced by THIS IS A TEST. When 
substitution mode is active, the processor performs substitutions. on 
each line before scanning the line for directives and MCR commands. 
(While obeying a .GOTO label directive, however, the processor ignores 
any undefined symbols encountered before the target line, that is, the 
line containing the specified label.) 


Escape recognition permits the response to an .ASK, .ASKN, or .ASKS 
directive to be an escape character. A question answered with a 
single escape character sets the special logical symbol <ESCAPE> to 
true. The escape character must be used only as an immediate 
terminator to the question; if one or more characters precede the 
escape, an error condition exists. In this case, the message 


AT.--INYALTID ANSWER OR TERMINATOR 
is printed and the query repeated. Note that if you type Cx) in 
response to an .ASK directive, the specified logical symbol (ssssss of 
-ASK ssssss txt-strng) is also set to true. 
Quiet mode is valid only in systems that support parent-offspring 
tasking; the directive performs no function in systems that do not 
Support parent-offspring tasking. In quiet mode, the processor does 
not echo Command Line Interpreter (CLI) command lines. The command 
lines are executed normally and, if they return a message or display, 
the message or display is printed on the terminal. 
Formats: 

«ENABLE LOWERCASE 

~ ENABLE SUBSTITUTION 


-ENABLE DATA [#n] 
(Brackets not part of syntax.) 


where: 
#n = optional file number in the range 0-3. Default is 0. 
You can substitute a numeric symbol for the value n by 
enclosing the symbol in apostrophes. 
»~ ENABLE GLOBAL 
-ENABLE ESCAPE 


» ENABLE QUIET 
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Examples: 


Substitution mode - 


» ENABLE SUBSTITUTION 
-ASKS FIL SPECIFY SOURCE FILE 
MAC 'FIL'='FIL' 


When the indirect file is executing, the corresponding lines 
displayed at the terminal are: 


* SPECIFY SOURCE FILE CS]:sguRCE 
>MAC SOURCE=SOURCE 


Lower-case mode - 


» ENABLE SUBSTITUTION 

«ENABLE LOWERCASE 

-ASKS A DEFINE STRING SYMBOL A 
ry 'At 

’ 


When the file is executing, the corresponding lines displayed 
at the terminal are: 


>* DEFINE STRING SYMBOL A [CSligsy is in cars 
PERGX is in caps 


Global symbol mode - 


The following two lines appear in an indirect command file 
BOB1: 


- ENABLE GLOBAL 
-SETS $X "TEST" 


A file called BOB2.CMD contains the following lines: 


.ENABLE SUBSTITUTION 
@BOB1 
MAC '$X', 'SX'='SX! 


Therefore, MCR displays the following when the file BOB2.CMD 
is run: 


>@BOB1I 
MAC TEST »TEST=TEST 
7@ <EOF> 


Data mode 


-OPEN SECFILE.DAT 
~ ENABLE DATA 


-DISABLE DATA 


The lines that fall between the .ENABLE and - DISABLE 
directives are written to the secondary file SECFILE.DAT. 
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e Escape recognition mode - 


;IF YOU WANT A LIST OF OPTIONS, TYPE <ESC> 
~ENABLE ESCAPE 

-ASKS A ENTER OPTION 

eIFT <ESCAPE> .GOTO LIST 


LIST: ;OPTIONS ARE: A (ADD), S (SUBTRACT), M (MULTIPLY) 


If the user types the escape key (which is not displayed) in 
response to ENTER OPTION, the corresponding lines displayed at 
the terminal are: 


24TF YOU WANT A LIST OF OPTIONS» TYPE «ESC» 
>* ENTER OPTION {S1: €6 
?FOPTIONS ARE: A (ADD)+ & (SUBTRACT) + M (MULTIPLY) 


e Quiet mode - 


«ASK QUIET DO YOU WANT COMMANT LINES SUPPRESSED 
eIFT QUIET .ENABLE QUIET 

-IFF QUIET .DISABLE QUIET 

ACT 


If the response is affirmative, the processor displays’ the 
active tasks, but not the Active command. For example: 


*>DO YOU WANT COMMAND LINES SUPPRESSED? CY/NI:y¥ 
MCRiss 
ACTT17 
AT.T1i7 


5.6.13 End Block » END 


The .END directive marks the end of the Begin-End block. If AT. 
encounters more .END directives than .BEGIN directives, command file 
processing terminates and displays the following message: 


AT. ~- ILLEGAL NESTING 
Format: 
~ END 


as the only directive on a line. 


5.6.14 Delete Symbols .» ERASE 


The ,ERASE directive deletes all local or global symbol definitions. 
When you define a symbol, either locally (by defining a symbol value) 
or globally (by enabling global symbol mode and preceding the symbol 
name with a dollar sign ($)), AT. creates an entry in a symbol table. 
The .ERASE directive erases either all local or all global entries in 
the table. 


Following an .ERASE directive, you can redefine symbol values as well 
as symbol type. 
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Formats: 
~ 
ERASE LOCAL 
» ERASE GLOBAL 
An .ERASE LOCAL directive outside of a Begin-End block erases all 
lecal symbols. An .ERASE LOCAL directive within a Begin-End block 
erases only those local symbols defined in the _ block. An  .ERASE 
GLOBAL, either outside of or within a Begin-End block, erases all 
global symbols. 
Example: 
~ ERASE LOCAL 
This directive erases all local symbol definitions for the indirect 
command file. 
5.6.15 Exit Current Command File «EXIT am, 


The ,EXIT directive terminates processing of the current command file 
or Begin-End block and returns control to the previous level command 
file or, if the directive is executed within a block, to the line 
following an .END directive. If the directive is encountered at the 
uppermost indirect nesting level, AT. exits and passes control to MCR 
(see the .STOP directive, Section 5.6.29). 


The directive also allows you to optionally specify a value to copy 
into the special symbol <EXSTAT>. 


Format: ~ 


~EXIT [value] 
(Brackets not part of syntax.) 


where value is an optional numeric expression to be copied to the 
special symbol <EXSTAT>. 


Examples: 

The following line appears in an indirect command file BOB]: 
@BOB2 ie 

The file BOB2.CMD contains the following line: 


«EXIT 


When AT. encounters the .EXIT directive in BOB2, control returns to 
BOB1.CMD. 


If the .EXIT directive in BOB2.CMD includes a numeric expression, for 
example: 


-EXIT N+2 


AT. evaluates the expression and copies the value into <EXSTAT>. 
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5.6.16 Call A Subroutine -GOSUB 


The .GOSUB directive saves the current position in an indirect file 
and then branches to a label. The label identifies an entry point to 
a subroutine which is terminated by a .RETURN directive. 


When you issue a .GOSUB directive from within a Begin-End block, AT. 
saves the current block context and then scans down the file searching 
for the first occurrence of the subroutine label. Note that during 
the scan, AT. ignores any intervening .BEGIN or .END directives. The 
»RETURN directive restores previous block context. Thus, the 
subroutine can be contained within a Begin-End block. 


The maximum nesting depth for subroutine calls is eight. 
Format: 
-GOSUB label 
where label is the label that designates the first line of a 
subroutine, but without the leading period and trailing colon. The 
label must be preceded by at least one space. 
Example: 
The directive 


-GOSUB EVAL 


transfers control to the subroutine labeled .EVAL:. 


5.6.17 Branch To A Label ~GOTO 


The .GOTO directive causes a branch from one line in an indirect file 
to another. All commands between the .GOTO directive and the 
specified label are ignored. Branches can go forward or backward in 
the file. 


When executing a .GOTO directive, AT. ignores all lines within a 
nested Begin-End block. Thus, the target label of a .GOTO directive 
cannot be contained within a block (unlike the target label of a 
~-GOSUB directive). Likewise, the target of a .GOTO branch from within 
a Begin-End block must be contained in that block; the .GOTO 
directive cannot branch into or out of a block. Note, however, that 
AT. permits branches across nested blocks. When AT. encounters a 
-GOTO directive within a Begin-End block, it scans for the label 
within that block. Since the label scan starts at the .BEGIN 
directive and continues to the .END directive, multiply defined labels 
are permitted within a block. 


Format: 
-GOTO label 


where label is the name of the label, but without the leading period 
and trailing colon. The label must be preceded by at least one space. 


Example: 
The directive 
-GOTO 100 
transfers control to the line containing the label .100:. 
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5.6.18 Logical Test IF 


A number of directives make tests; if the test is true, AT. 
processes the remainder of the command line. Logical tests can be 
combined into a compound logical test by using the .AND and .OR 
directives. 


5.6.18.1 Test If Symbol Meets Specified Condition .IF - The .IF 
directive compares a numeric or string symbol with another expression 
of the same type to determine if one of several possible conditions is 
true. If the condition is satisfied, the processor executes the 
remainder of the command line. When comparing a string symbol with a 
string expression, the indirect processor compares the ASCII values of 
each operand's characters (from left to right) one by one. An operand 
is considered greater if the first non-equal character has a greater 
value than the corresponding character in the other operand. Numeric 
symbols are compared strictly on the basis of magnitude. 


Format: 


-IF symbol relop expr 


where: 
symbol = 1- to 6-character name of numeric or string 
symbol. : 
relop = one of the following relational operators: 
EQ or = - equal to 
NE or <> - not equal to 
GE or >= - greater than or equal to 
LE or <= - less than or equal to 
GT or > - greater than 
LT or < - less than 
expr = expression of same type as symbol. 
Examples: 
-SETS X "A" 
-SETS Y "a" 


-IF X LT Y .GOTO 200 


The ASCII value of string symbol X is less than the ASCII value of 
string symbol Y, which satisfies the less than condition. Thus, 
control passes to the line containing the label .200:. 


~SETN Nl 2 
-SETN N2 7 
~IF N1 <= N2 PIP /LI 


With the condition satisfied (numeric symbol Nl less than or equal to 
numeric symbol N2), the PIP command is processed. 


-SETS S1 “AAb" 

-SETS S2 "AA" 

-SETS S3 "BBBB" 

eIF Sl >= &2+83[1:1] .INC N 


Since the condition where string symbol S1 is greater than or equal to 
string symbol S2 concatenated with the first character of string 


symbol S3 (AAb >= AAB) is satisfied, the processor increments numeric 
symbol N. 
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5.6.18.2 Test If Task Is Active Or Dormant .IFACT/.IFNACT - The 
-IFACT or .IFNACT directive tests whether a task is active (.IFACT) or 
dormant (.IFNACT). If the test is true, the rest of the command is 
processed. If the specified task is not installed, the processor 
assumes the dormant condition. 
Formats: 

eIFACT tttttt 

~ITFNACT tttttt 

wheres 


tttttt = a task name. 


The task name tttttt must be preceded and followed by at least one 
blank. 


Examples: 
~ITFACT REPORT .GOTO 350 


-IFNACT REPORT RUN REPORT 


5.6.18.3 Test If Symbol Is Defined Or Not Defined .IFDF/IFNDF - The 
-IFDF or .IFNDF directive tests whether a logical, numeric or string 
symbol has been defined (.IFDF) or not defined (.IFNDF). If the test 
is true, the rest of the command line is processed. This directive 
does not test the value of the symbol. 
Formats: 

-IFDF ssssss 

~IFNDF ssssss 

where: 

ssssss = 1- to 6-character symbol being tested. 

At least one blank must precede and follow the symbol. 
Examples: 


-IFDF A’ .GOTO 100 


e-IFNDF A .ASK A DO YOU WANT TO SET TIME 


5.6.18.4 Test If Task Is Installed Or Not Installed 
-IFINS/.IFNINS - The .IFINS or .IFNINS directive tests whether a task 
is installed (.IFINS) or not installed (.IFNINS) in the system. If 
the test is true, the rest of the command line is processed. 
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Formats: 
eIFINS tttttt 
-IFNINS tttttt 
where: 
tttttt = a task name. 


The task name tttttt must be preceded and followed by at least one 
blank. 


Examples: 
-IFINS PIP .GOTO 250 


-IFNINS PIP INS [1,50]PIP 


5.6.18.5 Test If Driver Is Loaded Or Not Loaded .IFLOA/.IFNLOA - The 
-IFLOA or .IFNLOA directive tests whether a driver is loaded (.IFLOA) 
or not loaded (.IFNLOA) in the system. If the test is true, the rest 
of the command line is processed. Note that for purposes of this 
directive, resident drivers are assumed to be loaded. 
Formats: 

~IFLOA dd: 

e~IFNLOA dd: 

where: 

dd: = a device driver. 

Examples: 


eIFLOA DK: .GOTO 250 


»IFNLOA DK: LOA DK: 


5.6.18.6 Test If Symbol Is True Or False .IFT/.IFF - The .IFT or .IFF 
directive tests whether a logical symbol is true or false. If the 
test is true, AT. processes the remainder of the directive line. 


The processor exits with a fatal error if the symbol being tested was 
previously defined as a numeric or string symbol. 


Formats: 
-IFT ssssss 
-IFF ssssss 
where: 
ssssss = 1- to 6-character logical symbol being tested. 


At least one blank must precede and follow the logical symbol. 
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Examples: 
-IFT A  .GOTO 100 


-IFF B .GOTO 200 


5.6.18.7 Compound Tests - You can combine "If" tests by using the 
»-AND and .OR directives. In addition, an implied .AND is effected 
when more than one IF appears on the same line without being separated 
by an .AND directive. The compound operators .AND and .OR must be 
preceded and followed by at least one blank. 


The .AND directive takes precedence over the .OR directive as shown in 
the following example: 


-IFT A .OR .IFT B .AND .IFT C .GOTO D 
That is, the processor reads the line as: 

IFT A .OR (.IFT B .AND .IFT C) .GOTO D 
Examples: 

IFT A .AND .IJFF B- .GOTO HELP 


If the logical symbol A is true and the logical symbol B is false, 
control passes to the line containing the label .HELP:. 


~IFT A .IFF B -GOTO HELP 
Same effect as the previous directive (.AND implied). 
eLlFT A .OR ~LFF B RUN PIP 


If the logical symbol A is true or if the logical symbol B is’ false, 
the MCR Run command is issued. 


5.6.19 Increment Numeric Symbol -INC 
The .INC directive increments a numeric symbol by 1. The processor 
exits with a fatal error if the symbol was previously defined as a 
logical or string symbol. 
Format: 

-INC ssssss 

where: 

SSSSSS = 1- to 6-character numeric symbol. 

Example: 


~INC N 


Increment by 1 the value assigned to the numeric symbol N. 


‘aa 
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5.6.20 Define Logical End Of File / 


The logical end of file directive (/) terminates file processing and 
exits. The message 


>@<EOF > 
is then displayed. 
Format: 
/ 
as the first non-blank character on a line. 
You can use this directive at any location in the command file to 


quickly terminate file processing, but care should be taken to avoid 
an inadvertent exit. 


Example: 
ASK CONT DO YOU WISH TO CONTINUE 
-IFT CONT .GOTO 100 
-100: 
5.6.21 Branch To Label On Detecting An Error ~ONERR 


If the processor detects one of the following errors: 
e Task not installed in system (.XQT, .WAIT, .IFACT, .IFNACT) 
e Undefined symbol 
e Bad syntax (.XQT, .WAIT, .DELAY) 
e Unrecognized command 
e String substitution error (any command) 
e Symbol type error (.IF, .IFT, .IFF, .INC, .DEC) 


e Redefinition of a symbol to a different type (.ASK, .ASKN, 
ASKS, .SETT, .SETF, .SETN, .SETS) 


e Data file error (.OPEN, .OPENA, .DATA, .CLOSE, between 
»~ENABLE DATA and .DISABLE DATA) 


control passes to the line containing the specified label. This 
feature provides you with a means’ of gaining control in order to 
terminate command file processing in an orderly manner. 


Note that the .ONERR directive applies only to the error conditions 
listed above; errors returned from a task external to AT. (for 
example, an MCR syntax error) are not processed by the .ONERR 
directive. 

Format: 


-ONERR- label 
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Upon detecting an error, the processor passes control to the line 
starting with .label:. The .ONERR directive must be issued before AT. 
encounters the error condition. If the directive is executed (one of 
the above errors is encountered), error processing passes to the 
specified label. Subsequent errors pass control to the same label 
until a new .ONERR directive is executed. If the label specified by 
the .ONERR directive does not exist and an error condition has 
occurred, indirect command file processing terminates. 


Example: 
-ONERR 100 


Upon detecting one of the above error conditions, the indirect command 
file processor passes control to the line labeled .100:. 


5.6.22 Open Secondary File - OPEN 


The .OPEN directive opens a specified secondary file as an _ output 
file. 


Format: 


-OPEN [#n] filename 
(Brackets not part of syntax.) 


where: 

filename = a file to be opened as an output file. Default 
file type is .DAT. 

#n = optional file number in the range 0-3 inclusive, 
allowing up to four data files to be open 
simultaneously. Default is #0. You can 
substitute a numeric symbol for the value n by 
enclosing the symbol in apostrophes. 

Example: 


«OPEN SECOUT 


This directive opens the file SECOUT.DAT as an output file. 


5.6.23 Open Secondary File For Append ~OPENA 


The .OPENA directive opens a secondary file and appends all subsequent 
data to the file. 
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Format: 


~OPENA [#n] filename 
(Brackets not part of syntax) 


where: 


filename = A secondary file to be opened with subsequent 
data appended to it. Default file type is .DAT. 


$n = optional file number in the range 0-3 inclusive, 
allowing up to four data files to be open for 
append simultaneously. Default is #0. You can 
Substitute a numeric symbol for the value n by 
enclosing the symbol in apostrophes. 
Example: 
~OPENA SECOUT 


This directive opens the file SECOUT.DAT as an output file and appends 
subsequent data to it. 


5.6.24 Pause Yor Operator Action » PAUSE 
The .PAUSE directive interrupts processing of an indirect file to wait 
for user action. A .PAUSE directive causes the indirect file 
processor task to stop itself. The user may then perform some 
operations and subsequently cause the task to resume. 
Format: 

»PAUSE 


When the indirect file processor task stops itself, it displays the 
following message on the entering terminal: 


AT. -- PAUSING. TO CONTINUE TYPE "UNS tttttt" 
where: 
tttttt = the name of the indirect file processor task. 
The operator then types the following command to resume the task: 
>UNS tttttt 
The indirect file processor then displays the message: 
AT. -- CONTINUING 


and it continues processing where it left off. 
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5.6.25 Return From A Subroutine «RETURN 
The .RETURN directive signifies the end of a subroutine and returns 
control to the most recently saved position in the indirect file (the 
line immediately following the .GOSUB directive that initiated the 
subroutine). 

Format: 


-RETURN 


5.6.26 Set Symbol To True Or False ~SETT/.SETF 
The .SETT/.SETF directives define or change the value of a specified 
logical symbol. If the symbol has not been defined, the processor 
makes an entry in the symbol table and sets the logical symbol to the 
value specified. If the symbol has already been defined, the 
processor resets the symbol accordingly. The processor exits with a 
fatal error if the logical symbol was defined previously as a numeric 
or string symbol. 
Formats: 

-SETT ssssss 

-SETF ssssss 

where: 


ssssss = 1- to 6-character logical symbol to be assigned a true or 
false value. 


The logical symbol ssssss must be preceded by at least one blank, 
Examples: 

-SETT X 
This directive sets the logical symbol X to true. 

~SETF ABCDE 


This directive sets the logical symbol ABCDE to false. 


5.6.27 Set Symbol To Numeric Value - SETN 


The .SETN directive defines or changes the numeric value of a 
specified symbol. If the symbol has not been defined, the processor 
makes an entry in the symbol table and sets the symbol to the numeric 
value specified. If the symbol has already been defined, the 
processor resets the symbol accordingly. The processor exits with a 
fatal error if the numeric symbol was previously defined as a logical 
or string symbol. 


INDIRECT COMMAND FILES 


Format: 
-SETN ssssss numexp 


where: 


ssssss l- to 6-character numeric symbol. 


numexp = a numeric expression. (See Section 5.3.3.1.) 

When specifying a numeric value to assign to a symbol, you may combine 
a numeric symbol or constant with another numeric symbol or constant 
to form a numeric expression. If numeric expressions are used, no 
embedded blanks or tabs are permitted. Evaluation is done from left 
to right unless parentheses are used to form subexpressions that are 
evaluated first. The type of an expression is octal if all the 
operands are octal; otherwise the type is decimal. 

Examples: 

»SETN NUMBER 27 


This directive assigns to the numeric symbol NUMBER the value 27 
(octal). 


~SETN Al 3* (A2-5) 


This directive assigns the numeric symbol Al the value of symbol A2 
Minus 5 multiplied by 3. 


5.6.28 Set Symbol To String Value -SETS 
The .SETS directive defines or changes the string value of a specified 
string symbol. If the symbol has not been defined, the processor 
makes an entry in the symbol table and sets the symbol to the 
specified string value. If the symbol has been defined, the processor 
resets the symbol accordingly. The processor exits with a fatal error 
if the symbol was defined previously as a logical or numeric symbol. 
Format: 
»SETS ssssss strexp 
wheres 
SSSSSS = l- to 6-character string symbol. 
strexp = any string expression. (See Section 5.3.3.2.) 
The processor assigns to the specified symbol the string value 
represented by the string expression strexp. If a string constant is 
used in strexp, the constant must be enclosed by quotes ("strexp"). 
You can combine a string symbol, constant, or substring with another 


string symbol or substring by the string concatenation operator (+) to 
form a string expression, 
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Examples: 
~SETS A "ABCDEF" 

This directive assigns to the string symbol A the string value ABCDEF. 
~SETS STR2 "Z2Zz" 

This directive assigns string symbol STR2 the value 222. 
~SETS X STR2+"ABC" 


This directive assigns string symbol X the value of symbol STR2 plus 
ABC (that is ZZZABC). 


«SETS X STR2+A[1:3] 
This directive is equivalent to the previous directive; it assigns 
the string symbol xX the’ string value of STR2 plus the first three 
characters of string A (that is ZZZABC). 

-SETS MYFILE <UIC>+"MYFILE.TXT" 
This directive assigns the string symbol MYFILE the string value of 
the current UIC plus the string MYFILE.TXT (for example, if the 


current UIC is [303,3], string symbol MYFILE is assigned the string 
value [303,3]MYFILE.TXT). 


5.6.29 Terminate Command File Processing «STOP 


The .STOP directive immediately terminates command file processing and 
exits. The message 


>@ <E0F? 
is then displayed. 


The .STOP directive allows you to optionally set the exit status for 
AT. execution. 


Format: 

-STOP [value] 
where value is an optional numeric expression to serve as the exit 
status for the indirect command file processor. If you do not specify 
an exit status value, the .STOP directive is identical to the logical 
end of file directive (/). 
Example: 


-STOP 0 


This directive terminates command file processing and sets AT. exit 
status to zero. 
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5.6.30 Test String Symbol -TEST 
The .TEST directive moves the length of a string symbol into the 
special numeric symbol <STRLEN>. It also tests the characters of the 
string and sets the special logical symbols <ALPHAN> and <RAD50> 
accordingly (see Section 5.3.1). 
Format: 

-TEST strsym 
where strsym is the string symbol to be tested. 
Example: 
The directive 

-TEST A 
moves the number of characters in string A into <STRLEN> and_ sets 
<ALPHAN> and <RAD50> accordingly. The special numeric symbol <STRLEN> 


is then available to compare the length of string symbol A to some 
numeric constant or expression. 


5.6.31 Wait For A Task To Finish Execution »WAIT 


The .WAIT directive suspends processing of the indirect command file 
until a particular task has terminated. 


Formats: 
WAIT tttttt 
The task name tttttt must be preceded by at least one blank. 
If the taskname is omitted, the indirect processor assumes the 


taskname applied by the last previous "RUN filename" MCR command. 
This name is specified as 


TTnn 

where: 
TT = the invoking terminal. 
nn = the terminal number. 


If the specified (or default) task is not installed, the indirect 
processor ignores the .WAIT directive. The .WAIT directive performs 
no function if the /NOMCR switch is in effect. 
Example: 

«WAIT PIP 


This directive discontinues processing of the command file until the 
terminal-initiated task PIP exits. 
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5.6.32 Initiate Parallel Task Execution ~XQT 


The indirect file processor usually passes a command to MCR and waits 
until the command's execution has completed. However, it is possible 
for the processor to initiate a task and not wait for it to complete 
before executing the next indirect file command. The MCR Run command 
initiates tasks, and the indirect file processor can continue as_ soon 
as the Run command is processed. However, you cannot use the Run 
command to pass a command string to the target’ task. The .XQT 
directive allows you to start a task, to pass a command string to it, 
and to continue processing command lines in parallel with the 
initiated task. AT. permits up to 10(10) successive .XQT directives. 


Formats 
-XQT tsk-name command-string 


where: 


tsk-name the name of the task (for example, MAC, 


PIP, DMO). 


the command to the task. 


command-string 


The .XQT command provides a facility to initiate parallel processing 
of tasks. Use the .WAIT directive to synchronize the execution of 
parallel tasks; command file processing is suspended until the 
specified task completes. 


Example: 


-XQT MAC TEST, TEST=TEST 
-XQT TKB BLD,BLD=BLD 
»WAIT MAC 

-WAIT TKB 


The example starts an assembly and a task build executing in parallel 
and then waits for the two tasks to complete. 


5.7 TASK NAME REFERENCES 


References to task names in an indirect command file follow the same 
rules as for MCR. If the task was started as an external MCR task 
(for example, MAC, PIP, DMO), it may be referenced by its 3-character 
name. Thus, the .WAIT, .IFINS, and ,IFACT directives need only 
specify the 3-character task name; the indirect command file 
processor can then find the correct task. Of course, you can always 
refer to a specific task by using its full 6-character name. 


5-37 


INDIRECT COMMAND FILES 


5.8 EXAMPLE COMMAND FILE AND ITS EXECUTION 


EXAMP .CMD 


we we Te 


-ENABLE SUBSTITUTION 
«ENABLE GLOBAL 


me Me Ne Ne 8 


This procedure calculates the day of the week from the 
date obtained from the system. 


DAYS OF THE WEEK. 


Cvs me me 8 


ETS DAYS "SUN MON TUESWED THURFRI SAT SUN" 
MONTHS OF THE YEAR. 
ETS MONTHS "JANFEBMARAPRMAYJUNJULAUGSEPOCTNOVDEC" 


NUMBERS FOR DAYS OF THE MONTH. 


ee © © ee © © © © © © © © © e@ @ 


we te we Cf) we te te 


~SETS DAYMON "01020304050607080910111213141516171819 2021222324252627 28 293031" 


-; NUMBERS FOR THE YEARS. 


-SETS YEARNM "7980818 28384858687888990919 29 3949596979899" 

~SETS DAT "'DATE>'" ! GET TODAYS DATE. 
-SETS TIM "'TIME>'" !IGET THE TIME. 

eSETS DAY DAT[1:2] EXTRACT THE DAY 

-SETS MONTH DAT([4:6] EXTRACT THE MONTH 
-SETS YEAR DAT8.:9.] EXTRACT THE YEAR 
-SETN DAYN 1. DAY OF MONTH COUNTER. 
-SETN NDX 1. DAY OF MONTH INDEX. 


oe om Ome om ome 


-DLOOP : 
-SETS TEMP DAYMON[NDX :NDX+1] 
IF TEMP = DAY .GOTO 10 
-INC DAYN 
e-SETN NDX NDX+2. 
-GOTO DLOOP 
10: -SETN MONCNT 1. 
eSETN NDX 1. 


SET TO DAY OF MONTH 
BRANCH IF CORRECT DAY 
BUMP COUNTER 

POINT TO NEXT DAY 

TRY NEXT DAY 

INIT MONTH COUNTER 
INIT MONTH INDEX 


ee 


»MLOOP: 
-SETS TEMP MONTHS [NDX :NDX+2.] 
eIF TEMP = MONTH .GOTO 20 
«INC MONCNT 
eSETN NDX NDX+3. 

-GOTO MLOOP 

-20: -SETN YEARN 79. 

-SETN NDX 1. 


SET TEMP TO MONTH 

BR IF CORRECT MONTH 
BUMP MONTH COUNTER 
POINT AT NEXT MONTH 
TRY NEXT MONTH 

INIT YEAR COUNTER. 
INITIALIZE YEAR INDEX. 


om ome ome ome om om tm 


» YLOOP: 
SETS TEMP YEARNM[{NDX :NDX+1] ! SET TEMP TO MONTH 
IF TEMP = YEAR .GOTO 30 ! BRANCH IF CORRECT YEAR 
e~INC YEARN ! BUMP YEAR COUNTER 
~SETN NDX NDX+2. ! POINT AT NEXT YEAR 
-GOTO YLOOP ! TRY NEXT YEAR 
7 
Fe 
os 

2303 -SETN Tl MONCNT+10. 
-SETN T2 T1/13. 

7 e-SETN T3 (13* (T1-(T2*12.))-1.)/5. 
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T3 (T1-(T2*12.)) 

T3 ((13.*T3)-1)/5. 

T3 T3+DAYN+77. 

T4 YEARN+( (MONCNT-14.)/12.) 
T4 YEARN 


~IF MONCNT < 3 .DEC T4 


~SETN 
»SETN 
7 -SETN 
-SETN 
-SETN 
-SETN 
-SETN 
-SETN 
eSETS 


The 
The 


See 


me Ne Ne Me Ne Se te 


@EXAMP 


neous 


ne tag 


The date is 
The time is 


De re 


i eer ee ee ee eet ee er ee | 


<EOF > 


ng 


T5 T4/100. 

T6 T4/400. 

T7 (5.*(T4-(T5*100.)))/4. 

T7 (T4-(T5*100.)) 

T7 (5.*T7)/4. 

T8 T3+T7+T6-T5-T5+1. 

DAYNDX T8-((T8/7.)*7.) ! DAY INDEX (SUNDAY = 0) 
DAYNDX (DAYNDX*4.)+1. ! INDEX INTO DAYS LIST 
SDAY DAYS [DAYNDX :DAYNDX+3.] ! GET DAY OF THE WEEK 


date is - 'DAT', 
time is - 'TIM', and 


Today is 'SDAY'DAY. 


you tomorrow. 


COMMAND FILE EXECUTION 


EXAMP.CMD 


- 1I7-APR-79+ 
- 13:25:37 and 


Today is TUESDAY. 


See you tomorrow, 
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MCR AND TKTN MESSAGES 


Messages from MCR and TKTN appear in this chapter in alphabetical 
order. Some messages include remedial action to be taken by the 
operator. This is not included with messages for which the required 
action is obvious or contained in the description of the message. 
11 40 F.P. EXCEPTION 
Explanation: This is a TKTN message. The task encountered a 
floating point exception while executing on a PDP-11/40, and no 
SST routine was specified to handle the trap. 
ABORTED BY DIRECTIVE OR MCR 


Explanation: Either MCR or an Executive directive issued by 
another task caused the task to be aborted. 


ABORTED VIA MCR 


Explanation: MCR aborted the task and requested a post-mortem 
dump. 


XXX -- ACCESS TO COMMON BLOCK DENIED 
Explanation: Common block protection requirements were not met. 
XXX -- ACCOUNT FILE OPEN FAILURE 


Explanation: The account file was open for another user; or the 
disk containing the account file was not mounted. 


User Action: Retry command. 


XXX -- ACCOUNT FILE RECORD(S) LOCKED 


Explanation: The account file or a specific record was locked. 
Retry the command. 


XXX -- ACP NOT IN SYSTEM 
Explanation: The specified Ancillary Control Processor was not 
installed in the system. 

XXX -- ADDRESSING EXTENSIONS NOT SUPPORTED 


Explanation: The command tried to install a task with a VSECT 
(virtual section) into a system that does not support the 
feature. 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


AST 


XXX 


XXX 


XXX 


XXX 
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-- ALIGNMENT ERROR 

Explanation: An attempt was made to create a partition, but’ the 
base address or size conflicted with existing partitions or 
physical memory size. ; 

~- ALLOCATION FOR SYS FILE EXCEEDS VOLUME LIMIT 

Explanation: The system was unable to allocate the system file 
from the specified block because intermediate bad blocks or 
end-of-volume was encountered. 

~- ALREADY MARKED FOR DISMOUNT 

Explanation: The device-unit has already been requested for 
dismount and the associated ACP was waiting for all accesses to 
the volume to complete. 

-- ALREADY MOUNTED 

Explanation: The specified network device was already mounted. 


-- AMBIGUOUS QUALIFIER 


Explanation: The qualifier does not specify a unique part of the 
Help file. 


User Action: Further information must be supplied. 
-- AMBIGUOUS SYNONYM 


Explanation: A qualifier in the Help file references an 
ambiguous shared entry. 


-~- ASSIGN FAILURE 


Explanation: The Hello command could not complete login logical 
assignments. For example, the MCR dispatcher is not installed. 


ABORT. BAD STACK 

Explanation: This is a TKTN message. An AST cannot be effected 
because the AST parameters cannot be pushed onto the task's 
stack. 

-- BAD BLOCK FILE CORRUPT - DATA IGNORED 
Explanation: The bad block file contained bad data. 

-- BAD BLOCK FILE FULL 
Explanation: The disk had more then 102 bad regions on it. 


-- BAD BLOCK HEADER I/O ERROR 


Explanation: A write error was detected in writing the bad-block 
file header. 


~- BAD COMMAND OR SYNTAX 


Explanation: The directive was unknown or the syntax of the 
directive was incorrect. 
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XXX -- BAD TASK FILE VBN, TASK REMOVED - taskname 


Explanation: The system removed the specified task because it 
contained a bad Virtual Block Number (VBN) in its file header. 


XXX -- BASE ADDRESS MUST BE ON 4K BOUNDARY 


Explanation: The base address of the task is not on a 4K 
boundary. This message is applicable only to mapped systems. 


XXX -- BASE MISMATCH COMMON BLOCK <common~name> 
Explanation: The base address of the common block, as recorded 
in the task image, did not match the base address of the resident 
common block. 


XXX -- BINARY OPERATOR ERROR 


Explanation: The .AND or .OR indirect-file-processor directive 
was not used correctly. 


XXX ~- BLOCK(S) EXCEED VOLUME LIMIT 


Explanation: The specified block (or blocks) exceeded the 
physical size of the volume. 


XXX -- BOOT BLOCK WRITE ERROR 


Explanation: An error was detected in writing the volume boot 
block. 


XXX -- BOOTED DEVICE'S DRIVER NOT LOADED 


Explanation: VMR has been used to unload the driver for the 
system (booted) disk. 


XXX -- BOOTED DEVICE NOT IN SYSTEM -- dd nnn mmmmmm 


Explanation: When the system was booted, Save could not find the 
booted device (device name dd, physical unit number nnn, CSR 
mmmmmm) in the system data structures. For example, the system 
was booted from DB3:, but the system data structures include only 
DBO: and DB1l:. 


XXX -- BYTE ADDRESS 


Explanation: The address specified as the argument to the Open 
command was an odd address. For example, the address 3000 is a 
legal address; however, the address 3001 is not. 


XXX -- CANNOT INSTALL PRIVILEGED TASK FROM NONPRIVILEGED TERMINAL 


Explanation: This message applies to multiuser protection 
systems only. A nonprivileged user attempted to install a 
privileged task. Only a privileged user can install a privileged 
task. 


MCR AND TKTN MESSAGES 


XXX -- CANNOT LOAD/UNLOAD A PSEUDO DEVICE 


Explanation: The device you attempted to load is a _ pseudo 
device. 


XXX -- CAN'T READ MCR COMMAND BUFFER 


Explanation: UFD was started by a Run command rather than by an 
MCR command; therefore, the command could not be parsed. 


XXX -~ CHECKING ddnn: 


Explanation: Automatic bad-block specification is proceeding, 
using the bad-block file produced by the Bad Block Locator 
utility program. 


XXX -- CHECKPOINT AREA TOO SMALL 


Explanation: The area allocated for checkpointing the task was 
smaller than the partition into which the task was’ being 
installed. This message applies only to systems that do not 
support the dynamic allocation of checkpoint space. 


CHECKPOINT FAILURE. READ ERROR 


Explanation: This is a TKTN message. The task could not be read 
back into memory after being checkpointed. 


XXX -~ CHECKPOINT FILE ALREADY IN USE ON DEVICE 


Explanation: A previous ACS command established a checkpoint 
file on the volume mounted on the specified device-unit. A 
volume can contain only one checkpoint file. 


XXX -- CHECKPOINT FILE HEADER I/O ERROR 


Explanation: An error was detected in writing out the checkpoint 
file header. 


XXX -- CHECKPOINT FILE NOW INACTIVE 


Explanation: This message appears after an ACS command has_ been 
issued and the file does not contain any checkpointed tasks. The 
message indicates that use of the file was discontinued 
immediately after the command was issued. If the file were still 
in use, TKTN would issue a message when the file was finally 
discontinued. 


*** Gdnn: -- CHECKPOINT FILE NOW INACTIVE 


Explanation: The message, issued by TKTN, indicates that a 
request to discontinue use of a checkpoint file on device ddnn: 
has finally been satisfied. The need to return tasks 
checkpointed to the discontinued file back into memory caused the 
delay between the request and this message. 


XXX -- CHECKPOINT FILE STILL ACTIVE 


Explanation: The command attempted to dismount a volume that 
contained an active checkpoint file. The volume cannot be 
dismounted until the checkpoint file has been discontinued. 


User Action: Issue an ACS command to discontinue the file and 


reissue the DMO command when the system issues a message to 
indicate that the checkpoint file is inactive. 
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XXX -- CHECKPOINT FILE STILL IN USE ON dev: 


Explanation: The system cannot be saved because a_ checkpoint 
file on the specified device is still active. 


User Action: Deallocate the checkpoint file (see the ACS 
command) and reissue the Save command. 


XXX -~- CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 
Explanation: A warning message. The checkpoint space allocated 
in the task image file is too small for the size-of the task 
(usually because of the /INC keyword). The system supports’ the 
dynamic allocation of checkpoint space and will therefore use a 
checkpoint file to contain the rolled-out task. 

**k* ddnn: CHECKPOINT WRITE ERROR 


Explanation: This is a TKTN message. A write failure occurred 
while the system was attempting to checkpoint a task. 


XXX -- CIRCULAR REDIRECT ERROR 


Explanation: An attempt was made to redirect a device, which 
would have caused a circular list of redirects to result. 


XXX -- CO: REDIRECTED TO CO: 
Explanation: The console output driver is active. 


User Action: If it is not active, use the Open command to 
redirect CO: to the terminal from which you are running. 


XXX -~- COMMAND INPUT ERROR 
Explanation: Circumstances prevented the BROADCAST task from 
receiving the command line (usually an indirect file could not be 
found); or, a system directive or the Run command, rather’ than 
the Hello command, has initiated the HELLO task. 
User Action: In the case of BROADCAST, retry the command. 

XXX -~ COMMAND I/O ERROR 
Explanation: An I/O error was generated during a read to an 
indirect file, or an attempt by another task to obtain a command 
from MCR failed. 

XXX -- COMMAND SYNTAX ERROR 
Explanation: The command line had an improper format. 


XXX -- COMMAND TOO LONG 


Explanation: An INITVOL or Mount command, including continuation 
lines, exceeded the maximum length of 512. characters. 


XXX -- COMMON BLOCK IS TASK PARTITION common-name 


Explanation: A task's request for access to a common block was 
rejected because the requested partition was a task partition. 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 
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-~- COMMON BLOCK NOT LOADED common-name 


Explanation: The specified common block was linked to the task 
but had not been loaded into the system. 


User Action: Install the specified common block, then install 
the task. 


-~- COMMON BLOCK OCCUPIED 


Explanation: An attempt was made to load a common block that was 
already occupied. 


-- COMMON BLOCK PARAMETER MISMATCH common~name 


Explanation: Parameters (partition name and PIC attributes) of a 
common block did not match those in the task's label block. 


-- COMMON BLOCK SEGMENT COUNT ERROR 
Explanation: The command installed a resident library with 
overlays, but the number of overlay segments specified in the 
task header is different from the number specified in the segment 
descriptors. 


-- COMMON common-name NOT INSTALLED FROM AN LB: 


Explanation: An RSX-11M-PLUS message. All checkpointable 
commons must be installed from an LB:. 


4 
User Action: Remove the common and retry the Save command. 
-- COMMON, DRIVER OR TASK ABOVE SYSTEM IMAGE FILE LIMIT 
Explanation: A system cannot be saved if a memory resident 


structure is higher than the amount of main memory that is 
written to the system image file. 


User Action: Use the Partitions command to determine the cause 
of the problem. 


-- COMMON NOT IN SYSTEM 


Explanation: The specified or required common does not exist in 
the current system. 


-- CONTINUING 

Explanation: This is not an error message. This message 
indicates that the indirect file processor is resuming execution 
after a .PAUSE or .DELAY directive. 

~- CTB name DOES NOT EXIST 


Explanation: The controller table name specified with the /CTB 
keyword does not exist in the resident database. 


-~ CTB NAME name IS A DUPLICATE 
Explanation: The loadable database contains a Controller Table 


(CTB) with a name that is the same as a CTB name in the resident 
database. CTB names must be unique. 
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XXX -- CTB name IS NOT SUPPORTED BY DRIVER-NOT LOADED 


Explanation: The device driver's dispatch table does not have 
all the Controller Table mnemonics that the rest of the database 
(the DCBs and CTBs) implies it to have or the CTB is defective. 
A defective CTB may contain a wrong name, or its linkage to the 
DCB may be wrong. 


XXX -- DCB TABLE FOR CTB name IS FULL 


Explanation: Load attempted to write the address of your Device 
Control Block (DCB) for the loadable database into the DCB table 
of the Controller Table. There were no null entries in the DCB 
table. (Refer to the RSX-11M or RSX-11M-PLUS Guide to Writing an 
I/O Driver.) 


XXX -- DATA ERROR 


Explanation: The specified bad-block number or the specified 
contiguous region size is too large. 


User Action: Reenter properly. 


XXX -- DATA FILE ERROR x. 


Explanation: The MCR indirect command file processor encountered 
an error while processing an .OPEN, .CLOSE, .DATA directive or a 
data mode access to the secondary file. See Appendix I in the 
IAS/RSX-11 I/O Operations Reference Manual for a definition of 


the numeric code x. 
XXX -- DELAYING 


Explanation: This is not an error message; it indicates that a 
.DELAY directive has just been executed by the indirect file 
processor. 

XXX -- DEVICE ATTACHED 


Explanation: The specified device was currently attached by a 
task and could not be mounted; or the specified device cannot be 
allocated because it is attached to a running task. 

XXX -- DEVICE ATTACHED [-dev:] 


Explanation: The device-unit specified in the command was 
attached by a task and could not be mounted. For attempts to 
mount one or more magnetic tapes, the message includes a specific 
device-unit. 

XXX ~- DEVICE ddn: HAS UNITS ATTACHED, BUSY, AND/OR MOUNTED 


Explanation: Device ddn: is the first or only unit that is 
attached, mounted, and/or has outstanding I/O. Therefore, the 
driver cannot be unloaded. 

XXX -- DEVICE NOT ALLOCATED TO THIS TERMINAL 


Explanation: The command line specified a private device that 
was allocated to other than the issuing terminal. 


XXX -- DEVICE NOT DEFINED IN NETWORK 


Explanation: The specified device had not been defined in the 
network topology and therefore could not be mounted. 
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-~- DEVICE NOT IN SYSTEM 
Explanation: The device specified in the command was not 
generated into the system. Devices to be used in the system must 
be specified during system generation. 


-~- DEVICE NOT IN SYSTEM -dev: 


Explanation: The Mount command specified a tape drive that has 
not been generated into the systen. 


-- DEVICE ddn: NOT IN SYSTEM 

Explanation: The data base for the device driver was neither in 
the system nor in the driver's task image; or specified device 
driver does not exist in the system. 

~- DEVICE NOT MOUNTED 
Explanation: The device specified in the file specification was 
not mounted. In response to a Load or Unload command, the system 
device (SY:) was not mounted, 

-~- DEVICE NOT REDIRECTABLE 
Explanation: The specified device may not be redirected. 


-- DEVICE NOT READY - ddnn: 


Explanation: The command specified a volume that was not ready 
(not up to speed). 


-- DEVICE NOT TERMINAL 


Explanation: An attempt was made to set terminal characteristics 
for a non-terminal device. 


-~ DEVICE NOT VARIABLE SPEED MULTIPLEXER 


Explanation: An attempt was made to set the baud rate for a 
terminal that was not attached to a DH11 or DZ11l multiplexer. 


-- DEVICE OFFLINE[-dev:] 
Explanation: The device specified in the command, although 
generated into the system, was not physically present in the host 
configuration. If the offline device is a magnetic tape drive, 
the message includes the device-unit. 

-~- DEVICE SPECIFIED TWICE -- dev: 


Explanation: The Mount command specified the same device-unit 
twice. 


~- DEVICE WRITE LOCKED - ddnn: 


Explanation: The command specified a volume that was 
write-locked. 


~- DIRECTIVE PARTITION UNFIXED OR NONEXISTENT 


Explanation: VMR has been used to make the contents of the 
directive partition disappear. Use VMR to restore it. 


XXX 


XXX 


KKK 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 


XXX 
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-- DIRECTORY ALREADY EXISTS 
Explanation: The requested UFD already exists on the volume. 
-~ DISK IS ALIGNMENT CARTRIDGE 


Explanation: The last track on an RKO6 disk identified the 
volume as an alignment cartridge, which cannot be initialized as 
a Files-1l volume. An alignment cartridge is specifically 
formatted for aligning disk read/write heads. 

ddnn: DISMOUNT COMPLETE 


Explanation: This is a TKTN message. This message indicates 
that the device requested for dismount is now logically 
disconnected from the system (that is, all files are deaccessed 
and the VCB is deallocated). 

~- DPB ERROR 


Explanation: A bad DPB was created by MCR. This error indicates 
that the system itself has faulted. 


User Action: If the error persists, submit a Software 
Performance Report (SPR) to DIGITAL. 


-- DRIVE LOAD/UNLOAD CALLS NOT SUPPORTED 

Explanation: The requested driver included the symbols $ddLOA or 
SddUNL in its source. These symbols are reserved for future use 
by the Load and Unload commands. 

-- DRIVER ALREADY RESIDENT 


Explanation: The specified device driver had already been 
loaded. 


-- DRIVER BEING LOADED OR UNLOADED 


Explanation: The Executive was effecting another request to load 
the driver. 


-~- DRIVER BUILT WITH WRONG EXECUTIVE STB FILE 


Explanation: The STB file for the driver was not compatible with 
the current Executive. 


-- DRIVER CANNOT BE UNLOADED 
Explanation: The Unload command attempted to remove a 
permanently resident device driver (that is, a driver linked to 
the Executive). 
-- DRIVER DISPATCH TABLE IS INCONSISTENT 
Explanation: The device driver's dispatch table is illegally 
formatted. Refer to the RSX-11M-PLUS Guide to Writing an I/0 
Driver. 
-- DRIVER LOAD/UNLOAD CALLS NOT SUPPORTED 
Explanation: The requested driver included the symbols $ddLOA or 


SddUNL in its source. These symbols are reserved for future use 
by the Load and Unload commands. 
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-~ DRIVER NOT LOADED 
Explanation: The device driver specified in the Unload command 
was not resident in memory; or the Mount command specified a 
device for which a driver was not loaded. 

-~ DUPLICATE BLOCK(S) FOUND 


Explanation: A block that had been specified as bad was being 
defined as bad a second time. 


-- DYNAMIC ALLOCATION OF CHECKPOINT SPACE NOT SUPPORTED 
Explanation: The ACS command was issued on a system that did not 
include support of dynamic allocation of checkpoint space at 
system generation. 


-- ERROR LOGGING STILL ACTIVE 


Explanation: A system cannot be saved while error logging is 
active. Run the task ERF to disable error logging. 


-- FAILED TO ATTACH DEVICE —- ddnn: 
Explanation: The specified device could not be attached. 
-- FAILED TO CREATE A DIRECTORY 


Explanation: No space existed on the volume, or an I/O error 
occurred. 


-- FAILED TO ENTER IN MFD 


Explanation: No space existed in the Master File Directory (MFD) 
or on the volume, or an I/O error occurred on the volume. 


-- FAILED TO READ BAD BLOCK FILE 


Explanation: The INITVOL command was unable to read the _ bad 
block information from the last track of an RKO6 disk. 


-- FATAL I/O ERROR 
Explanation: An input or output operation could not be completed 
because of the unavailability of a device or dynamic memory, or a 
device error occurred. 
-- FEATURE NOT SUPPORTED 


Explanation: The command keyword specifies an optional feature 
that was not incorporated into the system at system generation. 


-- FILE name CONTAINS INVALID DRIVER DATA BASE 
Explanation: The driver had an invalid data base. 
-~- FILE name HAS ILLEGAL STB FORMAT 


Explanation: The driver's STB file contained illegal object code 
or data. 
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-~ filename FILE HEADER I/0 ERROR 


Explanation: An error was detected in writing out the file 
header for the specified system file. 


-~ FILE HEADER READ ERROR 


Explanation: Mount could not read either the index file or the 
storage allocation file. 


User Action: Determine the problem; if it is a hardware error, 
contact the local Field Service office. 


-~ FILE I/O ERROR nnn. 


Explanation: The ACS command detected an error when it tried to 
allocate or open the checkpoint file. The code nnn. is an FCS 
error code that defines the cause of the error. See Appendix I 


of the IAS/RSX-11l I/O Operations Reference Manual. 
-- PILE filename HAS INCONSISTENT DRIVER LOAD INFORMATION 


Explanation: The partition for loadable drivers is logically 
beyond the end of the system image file. 


-- FILE name NOT A VALID DRIVER TASK IMAGE 


Explanation: The driver's task image was either overlaid or had 
a task header. 


-- FILE NOT CONTIGUOUS 
Explanation: An attempt was made to boot a system or install a 
task from a noncontiguous file. System images and task images 
must be contiguous. 


-- FILE name NOT CONTIGUOUS 


Explanation: The file specified was not contiguous. The file 
must be contiguous. 


-- FILE NOT FOUND 


Explanation: The requested file was not in the directory on the 
specified volume. 


~- FILE NOT IN USE 


Explanation: A checkpoint file was not in use on the device 
specified in the ACS command. 


-- FILE NOT TASK IMAGE 


Explanation: Data in the label block was not correct, indicating 
that the file was not a valid task image. 


-- FILE READ ERROR 
Explanation: An error was detected in reading an indirect file. 


This error is usually caused by records that are more then 80. 
bytes long. 
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XXX -- HOME BLOCK ALLOCATE WRITE ERROR 


Explanation: A write error occurred while the system was 
overwriting a bad home block area. 


XXX -- HOME BLOCK CHECKSUM ERROR 
Explanation: The checksum in the home block and the calculated 
checksum did not agree. This condition was probably caused by an 
I/O error. 


XXX -- HOME BLOCK I/O ERROR 


Explanation: An error was detected in reading or writing the 
volume home block. 


XXX -- HOME BLOCK READ ERROR 
Explanation: An error was detected in reading the home block. 
This error usually indicates that the volume is not ready in the 
drive. Wait until it is ready and reissue the command. 


XXX -- HOME BLOCK WRITE ERROR 


Explanation: A write error was detected in writing the volume 
home block. 


XXX -- ILLEGAL DEVICE ddnn: 


Explanation: The device specified at task-build time by _ the 
Assign command keyword option (Devices) did not exist in the 
system. 

XXX -- ILLEGAL DEVICE SPECIFIED 


Explanation: Specified device was not a terminal. 


XXX -- ILLEGAL DEVICE/VOLUME 
Explanation: The specified device was not a valid task-residence 
device. 

XXX -~- ILLEGAL DRIVER TASK APR USAGE 


Explanation: A device driver must be built for APR 5 and must be 
less than 4K (e.g., PAR=DRVPAR:120000:20000). This message 
applies to mapped systems only. 
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~- ILLEGAL FIRST APR 
Explanation: A privileged task, built to run using APR 4 or 5 as 
its base, was too large. Using APR 4, the task was larger than 
12K; using APR 5, the task was larger than 8K. If the Executive 
has been built to support 20K of address space, APR 5 is the only 


valid base APR for tasks mapping into the Executive. A 
privileged task that does not map into the Executive must use APR 


0 as its base. (See the RSX-11M/M-PLUS Task Builder Manual for a 
description of the /PR keyword.) This message applies only to 
mapped systems. 
~~ ILLEGAL FUNCTION 
Explanation: A command was entered that MCR could not recognize. 
~~- ILLEGAL KEYWORD COMBINATION 
Explanation: The command specified conflicting keywords. 
~~ ILLEGAL KEYWORD VALUE 
Explanation: A value entered for a keyword exceeded its limits. 
User Action: Enter a legal value. 


-- ILLEGAL PRIORITY 


Explanation: The value of the priority in the command was out of 
range (that is, not 1 to 250(10), inclusive). 


~~ ILLEGAL UIC 


Explanation: The command line specified an illegal UIC. 
~- ILLEGAL VALUE FOR SYMBOL symname IN FILE name 
Explanation: The symbol symname is defined to an illegal value 
by file ddDRV.STB. This can occur for several reasons; some 
general and some specific to individual symbols. For example, 
symbols cannot have odd values; most symbols cannot be defined 
as zero; S$ddTBL must exist and have a value less then SddEND; 
mapped loadable drivers cannot reference SINTSV. 
-- IMPROPER HELP FILE FORMAT 


Explanation: The Help file is not in proper format and cannot be 
used. Either edit the file or re-enter it in proper format. 


-- INDEX FILE BIT MAP I/O ERROR 


Explanation: An error was detected in writing out the index file 
bit map. 


-- INDEX FILE HEADER CHECKSUM ERROR 
Explanation: While rebooting a saved system, the system detected 
a checksum error in the file header of the index file. The error 
causes the system to halt. 

~- INDEX FILE HEADER READ ERROR 

Explanation: While rebooting a saved system, the system detected 


an error in the file header of the index file. The error causes 
the system to halt. 
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-- INDEX FILE I/O ERROR 


Explanation: An I/O error was detected in writing out’ the 
index-file header. 


-- INPUT I/O ERROR 


Explanation: In attempting to read the next command, the Open 
command detected an error. 


-- INSUFFICIENT ICB POOL SPACE FOR CPU CPx 
Explanation: There is not enough pool space to allocate an 
Interrupt Control Block for the CPU designated in the error 
message. This message applies only to Multiprocessor, I and D 
space systems. 
-~- INSUFFICIENT POOL SPACE 


Explanation: The required amount of pool space was not 
available. 


-- INTERRUPT VECTOR ALREADY IN USE 
Explanation: A loadable device driver interrupt does not point 
to one of the nonsense interrupt entries. This message can 
appear when a user issues the Load command. 
-- INVALID ACCOUNT 
Explanation: The name or UIC specified in the command is not 
stored in the account file; or the password specified does not 
Match the name or UIC given. 
-- INVALID ADDRESS 
Explanation: The address specified as an argument in the Open 
command referenced a nonexistent memory location or an address 
outside the boundaries of the specified partition. 
-- INVALID ANSWER 
Explanation: In response to a question from the indirect file 
processor directive .ASK, the operator entered a response other 
than Y, N, or null, followed by carriage return. The processor 
will repeat the question. 
-- INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE name 


Explanation: The driver had an invalid data base value at offset 
XXXX relative to the symbol SddDAT. 


-- INVALID KEYWORD 


Explanation: A keyword was encountered that was not recognized 
by the specific command processor. 


-~ INVALID INTERRUPT VECTOR 


Explanation: The interrupt vector address specified in the 
driver data base was too high. 
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-- INVALID LOAD DEVICE 


Explanation: The Boot or Install command detected a device that 
was invalid as a system or task-residence device. 


-~ INVALID SPEED 
Explanation: The multiplexer line specified does not support the 
requested speed; or the command specified unequal receive and 
transmit speeds for a DZ11. The DZ1l1l does not support split 
speeds. 

-- INVALID TIME PARAMETER 
Explanation: A time field was incorrect. 

-~- INVALID UIC 
Explanation: A value of zero was detected for either the group 
number or the member number. 

EXECUTION 

Explanation: This is a TKTN message. The subject task executed 
an IOT instruction, and no SST routine was specified to process 
the trap. 

-- I/O ERROR SIZING DEVICE - ddnn: 

Explanation: The system encountered an I/O error while sizing an 
RF1l1 disk. 

-- I/0 OUTSTANDING 

Explanation: Tasks that have I/O requests waiting to complete 
remain in the system. A system cannot be saved with I/O requests 
outstanding. 

User Action: Wait for the I/O requests to complete and reenter 
the command. 

-~ KRB name NOT IN LOADABLE DATA BASE 


Explanations You are attempting to load the driver for a MASSBUS 
device with a loadable data base. The special symbol (KRBname) 
which defines the location of the KRB is not defined in the 


loadable data base. Refer to RSX-11M-PLUS Guide to Writing an 
I/O Driver. 
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XXX -- LABEL BLOCK I/O ERROR 
Explanation: In saving the system image, the Save command writes 
the transfer address in the label block of the system image file. 
An error occurred during this write attempt. 

XXX -- LABEL BLOCK READ ERROR 


Explanation: The Boot command could not read the label block of 
the system image. 


XXX -- LENGTH MISMATCH COMMON BLOCK <common-name> 
Explanation: The length parameter for the common block, as 
described in the label block for the task image, did not match 
the corresponding length parameter defined in the system. A 
task's label-block data must match system data for that task 
before it can be installed. 


XXX -- LINE NOT DZ11 


Explanation: The command attempted to set to remote a line that 
was not attached to a DZ11 multiplexer. 


XXX -- LISTING DEVICE NOT AVAILABLE 


Explanation: The device-unit on which MCR was attempting to 
display information was attached and unavailable for use. 


XXX -- LOAD DEVICE NOT LB:, TASK REMOVED - taskname 


Explanation: The system removed the specified task while saving 
a system because the task had not been installed from LB:. 


LOAD FAILURE. READ ERROR 


Explanation: This is a TKTN message. The requested task could 
not be loaded because of a hardware error. 


XXX -- LOADABLE DRIVER SUPPORT NOT IN SYSTEM 


Explanation: The system generation option to support loadable 
device drivers was not chosen. 


XXX -- LOGICAL DEVICE NOT IN SYSTEM 


Explanation: The specified logical device was not defined in the 
logical device tables. 


XXX -- LOGINS ARE DISABLED 
Explanation: The system was in the process of shutting down; or 
the command SET /NOLOGON has been issued. A user cannot log onto 
a terminal at that time. 

XXX -- LUN OUT OF RANGE 
Explanation: An attempt was made to reassign a LUN that had a 


value greater than the maximum number of LUNs allocated for the 
task at task build. 
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XXX ~- MAGTAPE LABEL MUST BE SPECIFIED 


Explanation: An INITVOL command attempted to initialize a 
magnetic tape without specifying the required volume label. 


XXX -- MAGTAPE DEVICE ERROR ~ ddnn: 


Explanation: While positioning a magnetic tape before 
initializing it, the system encountered an I/O error. 


XXX ~~ MAGTAPE WRITE ERROR - ddnn: 


Explanation: While writing to the magnetic tape during 
initialization, the system encountered an I/O error. 


XXX -- MAXIMUM INDIRECT FILES EXCEEDED 
Explanation: An attempt was made to access an indirect file at a 
depth greater than four levels. MCR indirect files may nest to a 
maximum depth of four levels. 


XXX -- MCR IS NOT INSTALLED 


Explanation: When a system is booted, Save uses MCR to mount the 
system disk. MCR... must be installed using VMR. 


MEMORY PARITY ERROR IN PARTITION pname 


Explanation: This is a TKTN message. The error logging 

subsystem detected a memory parity error in the specified 

partition. TKTN prints this message as notification of such. 
MEMORY PROTECT VIOLATION 


Explanation: This is a TKTN message. The task encountered a 
memory protect violation, and no SST routine was specified to 
process the trap. 

XXX —-~ MESSAGE FILE ERROR nnn. 


Explanation: The system could not open the file LOGIN.TXT for a 
reason indicated by the FCS code nnn. See Appendix I of the 


IAS/RSX-11 I/O Operations Reference Manual for a definition of 
the FCS code. 
XXX -- MFD FILE HEADER I/O ERROR 


Explanation: An error was detected in writing out the Master 
File Directory (MFD). 


XXX ~- MFD WRITE ERROR 


Explanation: An error was detected in writing out the master 
file directory. 


MICRO CODE LOADER NOT INSTALLED 
Explanation: For systems that include the KMCll line printer 


driver (LKDRV), this message indicates that the task LPINIT is 
not installed in the system. 
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-- MOUNT ERROR FROM ACP —- XxXx. 

Explanation: The ACP detected an error while trying to mount the 
volume Set. See the IAS/RSX-1ll I/O Operations Reference Manual 
for a definition of standard FCS error codes. 

-- MULTI-UNIT DEVICE NOT TAPE 


Explanation: The command specified multiple units that are not 
tape drives. 


-- MUST BE RUN FROM TERMINAL CO: 
Explanation: Save is not being run from the terminal to which 
the pseudo device CO: is directed. This is not a requirement on 
an RSX-11M-PLUS system, therefore, the message does not apply. 

-~ NEW DEVICE NOT KNOWN TO SYSTEM 


Explanation: The new device in the Redirect command was not 
known to the system (that is, it does not exist in the device 
tables). 

-- NO BAD BLOCK DATA FOUND 
Explanation: Although automatic bad-block specification was 
selected, no bad=-block file could be found on the volume. This 
is a warning message. 

-- NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 


Explanation: This is a warning message. The command installed a 

task that was designated checkpointable at task build, but that 

had no checkpoint space allocated in its task image file. 

Because the system does not support the dynamic allocation of 

checkpoint space, it considers the task not to be checkpointable. 
-- NO LUNS 


Explanation: A LUN command specified a task that had no current 
LUN assignments. 


-~- NO POOL SPACE 


Explanation: The Executive could not currently satisfy MCR's 
request for dynamic memory. 


-~ NO ROOM AVAILABLE IN STD FOR NEW TASK 
Explanations No dynamic storage was available for making an 
entry in the System Task Directory (STD); therefore, the 
specified task could not be installed. 

-- NO TRANSFER ADDRESS 


Explanation: The Boot command could not find a transfer address 
in a virgin system image (result of task build). 


-- NO VOLUME LIST 


Explanation: The command specified a magnetic tape drive for 
which a mounted volume list does not exist. 
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~- NON EXISTENT MEMORY 


Explanation: An attempt was made to define a partition in 
nonexistent memory. 


RSX EMT EXECUTION 


Explanation: This is a TKTN message. The task executed an EMT 
instruction having an argument other than 377(8), and no SST 
routine was specified to process the trap. 

-- NOT ENOUGH APRS FOR TASK IMAGE 


Explanation: The Task Builder allows the user to specify the 
virtual base address of a task image as a multiple of 4K. 
Privileged tasks start at virtual 100000(8) to map the first 16K 
of the Executive, or virtual 120000(8) to map the first 20K of 
the Executive, at the same time as the user task. If the virtual 
base address is set too high, the task image may not be able to 
be mapped with the remaining mapping registers. This message is 
applicable to mapped systems only. 
-- NOT FILE STRUCTURED DEVICE 


Explanation: The system does not support Files-1ll on the 
specified device. 


~- NOT FILES-11 DEVICES 
Explanation: The command specified a device that did not contain 
a Files-1l disk. The specified device-unit must contain a 
mounted Files~-1ll disk. 
-- NOT MOUNTABLE DEVICE 
Explanation: The specified device was not supported as a 
Files-11 device (including ANSI magnetic tape) or a network 
device. 
-- NOT MOUNTED 
Explanation: The specified device was not mounted. 


ann: NOT READY 


Explanation: This is a TKTN message. The specified device was 
not ready. 


-- NOT SYSTEM IMAGE 


Explanation: The Boot command determined that the file was not a 
system image. , 


-- NOT VALID SAVE DEVICE 
Explanation: The device specified in the Save command was _ not 
valid. The Save command can specify only random access devices 
in Files-11 format. 


-- NT DEVICE NOT MOUNTED 


Explanation: The device NT: was not mounted. This device must 
be mounted before any other network devices. 
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-- NULL FILE HEADER I/O ERROR 


Explanation: An error was detected in writing out null-file 
headers to the index file. 


ADDRESS OR OTHER TRAP FOUR 
Explanation: This is a TKTN message. The task executed a word 
instruction with an odd address or referenced a nonexistent 
memory location in an unmapped system, and no SST routine was 
specified to process the trap. 

-- OLD DEVICE ATTACHED 


Explanation: An attempt was made to redirect an attached 
device-unit. 


-- OLD DEVICE MOUNTED 


Explanation: An attempt was made to redirect a mounted 
device-unit. 


-- OLD DEVICE NOT KNOWN TO SYSTEM 


Explanation: An attempt was made to redirect an unknown 
device-unit. 


-- OPEN FILE(S) ON ddnn: 


Explanation: There are open files on ddnn:. Insure that the 
queue manager is stopped. 


-- OTHER USER LOGGED ON 


Explanation: The issuing terminal was currently logged by 
another user. Only one user at atime can be logged onto a 
terminal. 

-- OTHER VOLUME MOUNTED{-~-dev:] 
Explanation: An attempt was made to mount a volume on a_ device 
that already had a mounted volume. The message specifies the 
device-unit if it is a tape drive. 


-~ OUTPUT ERROR 
Explanation: An MCR terminal-write operation failed. 
-- OVERLAP SEEKS NOT SUPPORTED 


Explanation: The command attempted to enable overlapped seek 
support for other than a DM, DP, or RH device controller. 


~- PARAMETER CONFLICTS WITH MOUNTED VOLUME 
Explanation: An attempt was made to mount a mounted volume with 


keyword parameters that conflict with those values specified when 
the volume was initially mounted. 


PARITY ERROR 


Explanation: This is a TKTN message. A parity error occurred 
during task execution. The task is fixed in memory so that the 
memory cannot be reused for another task. 
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-- PARTITION ALREADY EXISTS 


Explanation: An attempt was made to define a partition with a 
name already in use. 


-~- PARTITION BUSY 


Explanation: The partition in which a task was to be fixed was 
occupied by a running task; thus, the requesting task could not 
be fixed in that partition. 


-~ PARTITION parname BUSY 


Explanation: The user-controlled partition or subpartition into 
which the driver was to be loaded was already occupied, or there 
was not enough room in a system-controlled partition, (The Load 
command does not initiate checkpointing.) 


-- PARTITION parname IS A COMMON 
Explanation: An attempt was made to load a device driver into a 
common partition, A device driver cannot be loaded into a common 
partition. 


-- PARTITION parname IS NOT A COMMON 


Explanation: A partition specified for a common or resident 
library was not defined as a common partition. 


~- PARTITION NOT IN SYSTEM 


Explanation: The partition name specified as an argument in a 
command, or during task build, could not be found in the system. 


-~- PARTITION OR REGION name NOT IN SYSTEM 


Explanation: An attempt was made to load a driver into a 
partition that does not exist in the system, or Load found a 
symbol §$xxCOM in the driver and partition xxCOM does not exist in 
the system. 


-- PARTITION parname NOT IN SYSTEM 


Explanation: The partition specified either in the Load command 
or at task build was not in the system. 


-~ PARTITION par NOT IN SYSTEM, DEFAULTING TO GEN 


Explanation: This is a warning message. The specified partition 
does not exist; the system therefore attempts to install the 
task in the GEN partition. 


-- PARTITION parname NOT IN SYSTEM, TASK REMOVED —- taskname 


Explanation: This is an RSX-11M error message. If a task is 
installed in more than one system, the partition control block 
addresses in its header mapping windows may not be for the booted 
system. The task's label block indicates that the task maps to 
parname, but parname is not in the current system. The label 
block has probably been corrupted. 
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-~ PARTITION parname TOO SMALL 


Explanation: The partition into which the driver was to be 
loaded was not large enough to contain it. 


-- PARTITION TOO SMALL TO BUFFER INFORMATION 
Explanation: The specified listing command resulted in excessive 
output to the buffer. The information in excess of the buffer 
size is not displayed. 


-- PAUSING. TO CONTINUE TYPE "RES tttttt" 


Explanation: This is not an error message. The indirect file 
processor just executed a .PAUSE directive. 


NOT POSSIBLE 


Explanation: This is a TKTN message. A post-mortem dump was 
requested (or the task was built specifying a PMD), but the dump 
could not be generated. For example, the PMD task was not 
installed, the PMD task and the aborted task were in the same 
partition and not checkpointable, or there was not enough memory 
available. 


WILL BE GENERATED 


Explanation: This is a TKTN message that indicates that a 
post-mortem dump was requested and will be generated. 


-- PRIVILEGED COMMAND 


Explanation: A command that was available only to. privileged 
terminals was issued from a nonprivileged terminal. 


-- PRIVILEGED TASK LARGER THAN 12K 


Explanation: A privileged task was larger than 12K. Privileged 
tasks on an unmapped system have a maximum size of 12K. 


A-22 


MCR AND TKTN MESSAGES 


XXX -- PSEUDO DEVICE ASSIGNMENT ERROR 


Explanation: An attempt was made to assign a logical device name 
to a pseudo device. 


XXX -- PSEUDO DEVICE ERROR 


Explanation: The specified device is a pseudo device. Pseudo 
devices cannot be allocated or made public. 


XXX -- PSEUDO DEVICE REDIRECT ERROR 


Explanation: An attempt was made to redirect a pseudo device to 
another pseudo device. 


XXX -- PUBLIC DEVICE 


Explanation: The command attempted to allocate a public device. 
Public devices cannot be allocated, 


*** ddnn: READ FAILURE. CHECK HARDWARE STATUS 


Explanation: This is a TKTN message. The card reader driver 
detected a hardware error. 


XXX -- RECORD LARGER THAN 80. BYTES 


Explanation: An indirect file for MCR contained a record having 
a length greater than 80. bytes. 


XXX -= REDEFINING SPECIAL SYMBOL 


Explanation: An attempt was made to change the value of an 
indirect file processor special symbol (a symbol bracketed with < 
and >). Special symbols may not be redefined, 


XXX ~- REDEFINING SYMBOL TO DIFFERENT TYPE ssssss 


Explanation: An .ASK or a .SET type directive attempted to set 
the specified, already defined symbol to a different type. The 
first definition of a symbol determines its type (logical, 
numeric, or string); subsequent redefinitions must conform to 
the original type. 


XXX -- REGION/PARTITION name IS A COMMON 
Explanation: An attempt was made to load a device driver into a 
common partition. A device driver cannot be loaded into a common 
partition. 

RESERVED INST EXECUTION 


Explanation: This is a TKTN message. The task executed an 
illegal instruction, and no SST routine was specified to process 
the trap. 


XXX ~-=- RETRIEVAL POINTERS WRONG FORMAT 
Explanation: The index-file retrieval pointers were not in the 


correct format for RSX-11M. Refer to the IAS/RSX-11 I/0 
Operations Reference Manual for details, 
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XXX -- RUNNING ABOVE SYSTEM IMAGE FILE LIMIT 


Explanation: The system image file created to contain the saved 
system is RSX11M.SYS. This error message appears when RSX11M.SY5 
is not large enough to hold the memory in which both the system 
and the Save task run. The Save task must be included in the 
saved system image because Save is used to reboot the system. 
Either run the Save task in a _ partition lower in memory or 
rebuild the system with a larger system image file. 


ake ddnn: SELECT ERROR 


Explanation: This is a TKTN message. The selected device was 
not ready, or more than one drive had the same unit number 


XXX -- SPACE USED 


Explanation: An attempt was made to create a partition or a 
subpartition in a main storage area already occupied. 


XXX -~ SPECIFIED PARTITION FOR COMMON BLOCK 
Explanation: An attempt was made to install a task in a common 
block. 

XXX -- SPECIFIED PARTITION TOO SMALL 


Explanation: The task being installed was larger than the 
partition into which it was being installed. 


SST ABORT. BAD STACK 
Explanation: This is a TKTN message. An SST cannot be effected 
because the SST parameters cannot be pushed onto the task's 
stack, or a stack overflow was detected in an unmapped system, as 
indicated by a nonzero value in the header guard word. 


XXX -- STORAGE BIT MAP FILE I/O ERROR 


Explanation: An error was detected in writing out the _ storage 
allocation file header. 


XXX -- STORAGE BIT MAP FILE READ ERROR 


Explanation: An error was encountered while attempting to read 
the storage allocation. 


XXX -- STRING SUBSTITUTION ERROR 
Explanation: The MCR indirect command file processor encountered 
an error while performing a substitution. A probable cause for 
the error is either the omission of a second single quote or the 
fact that the symbol name did not correspond to a string symbol. 
XXX -- SYMBOL symname IS DOUBLY DEFINED BY FILE name 


Explanation: The symbol symname is defined twice by the file 
ddDRV.STB. 
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~~ SYMBOL symname IS UNDEFINED BY FILE name 


Explanation: The symbol symname was found in the file ddDRV.STB, 
but it was not a symbol definition. 


-~ SYMBOL TABLE OVERFLOW ssssss 


Explanation: The symbol table of the indirect file processor was 
full; there was no space for symbol ssssss. 


-~- SYMBOL TYPE ERROR ssssss 


Explanation: An .IF directive attempted to compare two types of 
symbol; ssssss is one of the compared symbols. Only symbols of 
the same type can be compared. 


~- SYNTAX ERROR 


Explanation: This message generally indicates that the required 
information was entered incorrectly. 


User Action: The user can usually correct this condition by 
retyping the arguments according to the command specifications. 


~~ SYSTEM MAY NOT BOOT CORRECTLY 


Explanation: [system uic]SAV.TSK was not found on the _ boot 
device. If SAV must’ be checkpointed in order to redirect and 
mount the booted device, the system disk will be overwritten, 
causing unpredictable results. 


~~ SYSTEM MAY NOT WORK - CORRUPTED FILE FOR COMMON comname 


Explanation: When Save attempted to convert to file ID for the 
common, Save found that the task image of the checkpointable 
common was corrupted or had been deleted. Save altered the 
System data structures to prevent checkpointing of the common 
into what may now be another task image. 


~~ TASK ACTIVE 


Explanation: The task used as the argument of the command was 
active, 


~- TASK ACTIVE IN ANOTHER SYSTEM, TASK REMOVED - taskname 


Explanation: The task is installed in another system as well as 
in the booted system. Since taskname is active and mapped to 
dynamic regions in the other system, it cannot be run in the 
booted system. 


~~ TASK ALREADY FIXED 


Explanation: The task used as the argument of the Fix command 
was fixed in memory. 


~~- TASK AND PARTITION BASES MISMATCH 
Explanation: The base of the partition did not match that of the 


task being installed. This message is applicable only to 
unmapped systems. 
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XXX -- TASK AND PARTITION parname BASES MISMATCH 


Explanation: The base address of the partition into which the 
driver was to be loaded did not match the base address of the 
partition address for which the task was built. This message 
applies to unmapped systems only. 


XXX -- TASK BEING ABORTED 


Explanation: A request for the execution of a task was made, but 
the task was being aborted either because of an error or because 
of an MCR Abort command. 


XXX -- TASK BEING FIXED 


Explanation: An attempt was made either to fix or to alter the 
priority of a task that was being fixed. 


XXX -- TASK CHECKPOINTABLE 


Explanation: An attempt was made to fix a checkpointable task in 
memory. A checkpointable task cannot be fixed in memory. 


TASK EXIT WITH OUTSTANDING I/0 


Explanation: This is a TKTN message. Tasks should terminate all 
I/O operations before exiting, even though the system performs 
all outstanding I/O when necessary. 


XXX -- TASK FILE DELETED, TASK REMOVED - taskname 


Explanation: While rebooting a saved system, a file 
identification that appears in the task control block (TCB) could 
not be found in the index file on the booted device. This 
indicates that the file has been deleted; deleted files do not 
contain valid task images. 


XXX ~- TASK FILE HEADER ERROR, TASK REMOVED - taskname 


Explanation: While rebooting a saved system, a task's file 
header could not be found and the task was therefore removed. 


XXX -- TASK FILE HEADER READ ERROR, TASK REMOVED - taskname 


Explanation: The system removed the specified task because it 
encountered a failure while reading the task's file header. 


XXX -- TASK HEADER READ ERROR 


Explanations The system detected an I/O error while reading in 
all task headers to store file identifications in the TCB. The 
error causes the system to loop. 


XXX -~- TASK IMAGE ALREADY INSTALLED 


Explanation: The requested task image, which was checkpointable, 
had already been installed. On systems that do not support the 
dynamic allocation of checkpoint space, checkpointable tasks that 
do not have checkpoint space allocated can be installed only 
once; other tasks can be installed more than once. 
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XXX -- TASK IMAGE I/O ERROR 
Explanation: Install could not read the task-image file, or 
Install could not rewrite the task-image header. (The device is 
write-locked. ) 

XXX -- TASK IMAGE I/O ERROR IN FILE filename 
Explanation: The device is probably write-locked. MCR could not 
read the task-image file or could not rewrite the task image 
header. 

XXX -- TASK IMAGE CURRENTLY INSTALLED 


Explanation: The requested task image was already installed. 
This message is applicable only to checkpointable tasks. 


XXX -- TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK blockname 
Explanation: The virtual addresses reserved for the task image 
overlap those reserved for the common block specified in the 
message. A corruption of the task image file probably caused the 
overlap. 

TASK INSTALLED IN MORE THAN ONE SYSTEM 
Explanation: This is a TKTN message. Since the task is active 
and mapped to dynamic regions in one system, it cannot be 
installed in another. 

XXX ~- TASK INSTALLED IN PARTITION 


Explanation: An attempt was made to eliminate a partition 
containing installed tasks. 


XXX ~- TASK MARKED FOR ABORT 
Explanation: A previous request has already been made to abort 
the specified task, but the abort has not yet occurred. The task 
marked for abort is probably not currently resident in memory. 


XXX -~ TASK NAME ALREADY IN USE 


Explanation: An attempt was made to install a task with the same 
name as one already in the system. 


XXX -- TASK NOT ACP 


Explanation: The task specified as an ACP did not have the 
characteristics of an ACP. 


XXX -~- TASK NOT ACTIVE 
Explanation: The specified task was not currently active. 
XXX -- TASK NOT FIXED 


Explanation: An attempt was made to unfix a task that was not 
fixed, or to open a memory location of a task that was not fixed. 


XXX -~ TASK NOT IN SYSTEM 


Explanation: The specified task had not been installed. 
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XXX -~- TASK NOT IN SYSTEM tttttt 
Explanation: An .IFACT, .IFNACT, or .WAIT directive referred to 
a task that was not installed. These three directives can only 
specify an installed task. 

XXX -- TASK NOT SUSPENDED 


Explanation: The task used as the argument of the Resume command 
was not suspended. 


XXX -~ TASK taskname HAS OUTSTANDING I/O 


Explanation: A system cannot be saved if a task is waiting for 
I/O to complete. 


XXX -- TASK taskname IS ACTIVE AND CHECKPOINTED 


Explanation: You cannot save a system if it contains an active 
and checkpointed task. This restriction prevents a possible 
system crash; if the task was installed in another system image 
file, the task image could be corrupted when the task was run in 
the second system. 


XXX -~ TASK taskname IS CONNECTED TO AN INTERRUPT VECTOR 


Explanation: Disconnect the task from the interrupt vector or 
abort it and retry the Save command. 


XXX -~ TASK taskname NOT INSTALLED FROM AN LB: 


Explanation: All tasks must be installed from an LB:. Use the 
TAS command and determine which tasks are not. Retry the Save 
command after removing the tasks or installing them from an LB:. 


TBIT TRAP OR BPT EXECUTION 
Explanation: This is a TKTN message. The task has either set 


the T bit in the Processor Status Word or executed a Breakpoint 
Trap instruction, and no SST routine was specified to process the 


trap. 

XXX -~ TERMINAL ALLOCATED TO OTHER USER 
Explanation: The issuing terminal has been allocated to another 
user. A user cannot log onto a terminal allocated to someone 
else, 

XXX ~~ TERMINAL IS BUSY -- ttn: 


Explanation: The broadcast message could not be displayed within 
10 seconds at the terminal specified by ttn:. 


TRAP EXECUTION 
Explanation: This is a TKTN message. The task executed a TRAP 
instruction, and no SST routine was specified to process the 
trap. 

XXX -~- TI REDIRECT ERROR 


Explanation: An attempt was made to redirect the pseudo device 
TI:. This device cannot be redirected. 
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XXX -- TOO MANY COMMON BLOCK REQUESTS 


Explanation: A task is limited to seven common block references. 

XXX -~ TOO MANY LUNS 
Explanation: A task attempted to assign more than 255(10) LUNs. 

XXX -- TOO MANY SUBPARTITIONS 
Explanations An attempt was made to assign more than seven 
subpartitions in a user-controlled main partition. A main 
user-controlled partition is limited to a maximum of seven 
subpartitions. 

XXX -- TOO MANY SYMBOLS OF THE FORM $xxTMO IN FILE filename 
Explanation: Load is attempting to extract symbols of the form 
SxxTMO from the drivers symbol definition file. There are more 
symbols of this form than LOAD can process. 

XXX -- UNDEFINED COMMON BLOCK commonname 
Explanation: A task referenced a common block that was not 
defined in the system. Usually, this message indicates that the 
task was built to run in another system. 

XXX -- UNDEFINED DENSITY SELECTION 
Explanation: The command specified an illegal density value. 


XXX -- UNDEFINED LABEL 111111 


Explanation: The label 111111 specified in a .GOTO or .ONERR 
directive could not be found. 


XXX -- UNDEFINED SYMBOL ssssss 


Explanation: The symbol ssssss was being tested, but it had not 
been defined by the indirect command file. 


XXX -- UNIT DOES NOT SUPPORT 800 BPI 


Explanation: The command specified a drive that does not support 
800 BPI. 


XXX -- UNIT DOES NOT SUPPORT 1600 BPI 


Explanation: the INITVOL command specified a tape drive that 
does not support 1600 bpi. 


XXX =-- UNIT DOES NOT SUPPORT HIGH/LOW DENSITY SELECTION 


Explanation: The command specified a device for which the High 
and Low keywords are undefined. 
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XXX -- UNIT DOES NOT SUPPORT DENSITY SWITCH 


Explanation: The command specified a device which does have 
multiple density capability. 


XXX -- UNIT IS NOT AT LOW DENSITY 
Explanation: The command line specified that a floppy disk in an 
RX02 drive be initialized at low density, but the floppy was 
formatted at high density. 

XXX -- UNIT IS NOT AT HIGH DENSITY 
Explanation: The command line specified that a floppy disk in an 
RX02 drive be initialized at high density, but the floppy was 
formatted at low density. 

XXX -- UNITS ATTACHED, BUSY, AND/OR MOUNTED 
Explanation: One or more device units handled by the driver are 
attached, mounted, and/or have outstanding 1/0. Therefore, the 
driver cannot be unloaded. 

XXX -- UNKNOWN MAIN PARTITION 


Explanation: An attempt was made to define a subpartition of a 
nonexistent main partition. 


XXX -- UNKNOWN QUALIFIER 


Explanation: The Help file does not contain the last qualifier 
printed in the display of the command line below the error 
message. 


*** ddn: UNRECOVERABLE HARDWARE DEVICE ERROR 


Explanation: This is a TKTN message. The error logging 
subsystem recorded an unrecoverable hardware error. MTKTN prints 
this message as notification of such. 


XXX -- USER LOGGED ON TERMINAL 


Explanation: The command attempted to allocate a terminal that 
has been logged by another user. Logged terminals cannot be 
allocated. 


XXX -—~ USER PARTITION >32K NOT PERMITTED 


Explanation: The command attempted to create a partition greater 
than 32K. Partitions greater than 32K cannot be created in 
systems that do not support dynamic memory allocation, a system 
generation option. 


XXX -- VOLUME MOUNTED FILES-11l 
Explanation: An attempt was made to initialize a mounted 


Files-1l volume. Mounted Files-ll volumes can not be 
initialized. 
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-- VOLUME MOUNTED FOREIGN WITH ACP 


Explanation: The command line specified a device that was 
mounted foreign, but with an ACP. To initialize a volume in 
RSX-11M-PLUS, you cannot include an ACP name when the volume is 
mounted as foreign. 


ae VOLUME NAME TOO LONG - (volume name) 


Explanation: The command line specified a volume label that 
exceeded six characters for magnetic tape devices or twelve 
characters for disk devices. 

-- VOLUME NOT MOUNTED 


Explanation: An attempt was made to create a UFD on a_ volume 
that was not mounted. A volume on which a UFD is to be created 
must be mounted. 
-- VOLUME NOT MOUNTED BY TI: 


Explanation: The command specified a dismount operation for a 
volume that was not mounted from the issuing terminal. 


-- VOLUME NOT READY 


Explanation: The command specified a volume that was not ready 
(not up to speed). 


-- VOLUME(S) STILL MOUNTED 
Explanation: A system with mounted volumes cannot be saved. 
User Actions To correct the problem, dismount the volumes’ and 
retry the command. The MCR Devices command can be used to 
display the mounted volumes. 


-- VOLUME STRUCTURE NOT SUPPORTED 


Explanation: RSX-11M/M-PLUS does not support the Files-11 
structure level of the volume being mounted. 


In response to a Save command, while rebooting a saved system, 
the system determined from the disk's home block that the disk's 
structure is not supported by the current version of 
RSX-11M/M-PLUS. This error causes the system to halt. 


-- VOLUME WRITE LOCKED 

Explanation: The command specified a volume that was 
write-locked and therefore could not be initialized as a Files-ll 
device. 


-- WARNING BLOCK 0 IS BAD 


Explanations Block 0 of the specified volume, the boot block, 
was bad. A bootable image cannot be placed on this volume. 


~~ (WARNING) COULD NOT SIZE BOOTED DEVICE 


Explanation: Save recognized the device name as a device that it 
should size, but it could not size it. The UCB words U.CW2 and 
U.CW3 for the booted device may incorrectly indicate device size. 
I/O errors may result. 
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~- WARNING - KRB name INTERRUPT VECTOR nnn IN USE 


Explanation: An attempt was made to load a driver that specifies 
an interrupt vector which is not pointing to a nonsense interrupt 
entry point address. This is usually caused by a _ previously 
loaded driver which has used this vector. 


When you get this message, Load has loaded the driver correctly, 
but it has not overwritten the interrupt vector. 


-- WARNING - KRB name INTERRUPT VECTOR nnn TOO HIGH 


Explanation: An attempt was made to load a driver that specifies 
an interrupt vector address that is higher than the highest 
permissible vector address in your system. 


When you get this message, Load has loaded the driver correctly, 
but it has not overwritten the interrupt vector. 


-~ WARNING — LOADABLE DRIVER LARGER THAN 4K 


Explanation: Loadable drivers can be up to 8K words in length. 
The driver must explicitly map to any locations above 4K words. 


-- (WARNING) NONEXISTENT LUN ASSIGNMENT FOR TASK taskname 


Explanation: The physical device to which Save was attempting to 
rebind a LUN does not exist in the booted system. This condition 
is resolved if the task performs a run-time assignment to. the 
LUN, otherwise, the task will encounter an error condition when 
it attempts to use the LUN. 


~- WARNING - PRIVILEGED TASK OVERMAPS THE I/O PAGE 


Explanation: A privileged task that is mapped into the Executive 
is usually also mapped into the I/0 page to access the KT1l 
registers and other devices. Many tasks do not require this 
access and can use _ the additional 4K words of virtual address 
space for the task image. This message warns that a task that 
May require access to the I/O page might have grown too large. 


~- WRITE ATTRIBUTE FAILURE 


Explanation: An error was encountered in writing the attributes 
of either the MFD or the newly created UFD. 


-- WRITE CHECK NOT SUPPORTED 
Explanation: An attempt was made to support write check for a 
device other than a RKO5 or RKO6 disk. Write check is supported 
only for RKO5 and RKO6 disks. 

-- WRONG VOLUME LABEL 


Explanation: The volume label and the label specified in the 
command did not match. 
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I/O requests, 

redirecting, 4-169 
I/O rundown, 4-10 
Identification Code 

User (UIC), 2-14, 3-1, 3-5 
-IF directive, 5-26 
.IFACT directive, 5-27 
.IFDF directive, 5-27 
.IFF directive, 5-28 
.IFINS directive, 5-27 
.IFLOA directive, 5-28 
.IFNACT directive, 5-27 
.IFNDF directive, 5-27 
~IFNINS directive, 5-27 
»IFNLOA directive, 5-28 
IFT directive, 5-28 
Image, 

booting system, 4-139 

saving system, 4-172 
~INC directive, 5-29 
/INC keyword, 4-148 
Indirect command file, 5-1 

nested, 5-11 

specifying an, 5-1 
Indirect file processing, 

suspending, 5-36 
Indirect File Processor, 

directives, 5-2 

MCR, 5-2 

switches, 5-10 

symbols, 5-5 

variables (see symbols) 
/INDX keyword, 4-55 
/INF keyword, 4-55 
Informational commands, 4-6 

ACT, 4-6, 4-14 

ATL, 4-6, 4-21 

CBD, 4-6, 4-29 

CLQUEUE, 4-7, 4-143 

DEVICES, 4-7, 4-32 

LUNS, 4-7, 4-64 

PARTITIONS, 4-7, 4-76 

TAL, 4-7, 4-127 

TASKLIST, 4-7, 4-128 
INI, 4-51 
Initialization commands, 4-6 

ACS, 4-6, 4-135 
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Initialization commands (Cont.) 
ASN, 4-6, 4-18 
BOOT, 4-6, 4-139 
DMOUNT, 4-6, 4-36 
FLAGS, 4-6, 4-40 
INITVOLUME, 4-6, 4-51 
INSTALL, 4-6, 4-146 
LOAD, 4-6, 4-157 
MOUNT, 4-6, 4-65 
SET, 4-6, 4-87 
TIME, 4-6, 4-130 
UFD, 4-6, 4-131 
UNLOAD, 4-6, 4-185 
Initialize Volume command, 
3-1, 4-51 
Initializing FILES-11 volume, 
4-51 
Input, 
solicited, 2-7 
unsolicited, 2-7 
Input file, 3-3 
Input prompt, 2-7, 4-1, 4-2 
INS, 4-146 
Install command, 4-146 
Install-run-remove command, 4-80 
Installed tasks, 
displaying status of, 4-127 
removing, 4-171 
_ Installing a task, 1-3, 4-146 
Interchange Program, Peripheral, 
(PIP), 3-2 
Interface, 
monitor console, 4-2 
Interval, 
time, 4-80 
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Keyword, 4-3 
/ACP, 4-68 
/APF, 4-148, 4-165 
/ALL, 4-14 
/ALLOC, 4-131 
/BAD, 4-52 
/BLKS, 4-135 
/BUF, 4-89 
/CHA, 4-54 
/CKP, 4-83, 4-148 
/COLOG, 4-121 
/COTERM, 4-122 
/CPU, 4-165 
/CRE, 4-90 
/CRT, 4-90 
/CTB, 4-158 
/DCL, 4-91 
/DENS, 4-54, 4-68 
/DEV, 4-37 
/DRV, 4-166 
/EBC, 4-91 
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Keyword (Cont.) 
/ECHO, 4-93 
/ELIM, 4-40 
/ESCSEQ, 4-92 
/EST, 4-148 
/EXT, 4-54, 4-68 
/FDX, 4-94 
/FOR, 4-68 
/FORMFEED, 4-95 
/FPRO, 4-55, 4-69 
/HFILL, 4-96 
/HHT, 4-96 
/HIGH, 4-158 
/HOLD, 4-97 
/KNL, 4-165 
/KNLD, 4-166 
/KNLI, 4-166 
/LIBUIC, 4-113 
/LINES, 4-97 
/LOCK, 4-37 
/LOG, 4-32 
/LOGFILE, 4-123 
/LOGON, 4-112 
/LOWER, 4-99 
/LRU, 4-56, 4-69 
/MAIN, 4-114 
/MAXEXT, 4-119 
/MAPKT, 4-112 
/MCR, 4-100 
/MOU, 4-174 
/MXF, 4-56 
/NOCOLOG, 4-122 
/NOCON, 4-175 
/NOCOTERM, 4-123 
/NOCRT, 4-90 
/NOEBC, 4-92 
/NOECHO, 4-93 
/NOESCSEQ, 4-93 
/NOFORMFEED, 4-95 
/NOFDX, 4-94 
/NOHHT, 4-97 
/NOHOLD, 4-98 
/NOLOGON, 4-112 
/NOLOWER, 4-99 
/NOMAIN, 4-115 
/NOOVLP, 4-101 
/NOPAR, 4-118 
/NOPRIV, 4-102 
/NOPUB, 4-102 
/NOREMOTE, 4-103 
/NORPA, 4-104 
/NOSLAVE, 4-105 
/NOSUB, 4-117 
/NOTYPEAHEAD, 4-108 
/NOVFILL, 4-109 
/NOWCHK, 4-110 
/NOWRAP, 4-111 
/OVLP, 4-100 
/OVR, 4-69 
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INDEX 


Keyword (Cont.) Line, 
/OVREXP, 4-70 deleting a, 2-5 
/OVRFSID, 4-69 erasing a, 2-5 
/PAR, 4-84, 4-117, 4-149, 4-157, retyping current, 2-5 
4-165 Line terminator, 2-2, 2-5, 4-1 
/PARM, 4-70 Line terminator options, 4-166 
/PMD, 4-11, 4-84, 4-149 List option, 2-21 
/POOL, 47118 Listing account entries, 2-21 
/PRI, 4-84, 4-138, 4-149 LOA, 4-157 
/PRIV, 4-101 Load command, 4-157 
/PRO, 4-57, 4-132, 4-149 Loadable device driver, 4-157, 
/PRTCL, 4-71 4-185 
/PUB, 4-102 Loading nonresident device 
/RCK, 4-72 driver, 4-157 
/REG, 4-144, 4-165, 4-184 Local assignment, 4-18 
/REMOTE, 4-103 Local logical name, 2-12 
/RON, 4-144, 4-150, 4-184 /LOCK keyword, 4-37 
/ROPAR, 4-84, 4-150 /LOG keyword, 5-33 
/RPA, 4-104 /LOGFILE keyword, 4-123 
/RPRI, 4-138 Logging off terminal, 2-13, 2-15, 
/RSI, 4-80 4-27 
/SEFILE, 4-174 Logging onto terminal, 2-13, 
/SIZE, 4-158 2-15, 4-41 
/SLAVE, 4-105 Logical assignment, 
/SLV, 4-84, 4-150 defining, 4-18 
/SPEED, 4-106 deleting, 4-18 
/SUB, 4-116 displaying, 4-18 
/SYNC, 4-150 Logical Block Number (LBN), 
/SYSUIC, 4-113 4-146, 4-173 
/TASK, 4-85, 4-151, 4-165 Logical device, 2-12, 2-13 


/TEL, 4-72 Logical device assignment, 
/TERM, 4-4, 4-5, 4-14, 4-37, 2-13, 4-18 
4-138 Logical device table, 2-13 


/TYPEAHEAD, 4-107 

/UIC, 4-58, 4-70, 4-80, 4-85, 
4-108, 4-151 

/UNL, 4-70 

/USER, 4-37 

/VEILL, 4-109 

/VI, 4-58, 4-70 


Logical name, 2-12 

assigning, 4-18 

global, 2-13 

local, 2-13 

login, 2-13 
Logical symbols, 5-5, 5-6 
Logical test of symbols, 5-26 


/WB, 4-174 Logical Unit Number (LUN), 
/WCHK, 4-110 2-11 

/WIN, 4-58, 4-70 Logical Unit Numbers command, 
/WRAP, 4-111 4-64 


Logical-device assignment, 2-13, 


Keyword value, 4-3 

/KNL keyword, 4-165 
/KNLD keyword, 4-166 
/KNLI keyword, 4-166 


L 


Label, 
branching to a, 5-25 
command file, 5-12 
Label on error, 
branching to, 5-30 
LBN, 4-146, 4-173 
/LIBUIC keyword, 4-113 
/UINES keyword, 4-97 


2-14, 4-18 
Login assignment, 4-18 
Login logical name, 2-13 
/LOGON keyword, 4-112 
Logon UIC, 3-5 
Logons, 
disabling, 4-112 
enabling, 4-112 
/LOWER keyword, 4-99 
/LRU keyword, 4-56, 4-69 
LUN, 4-64 
LUN assignments, 
displaying, 4-64 
LUNs, 2-11 
reassigning, 4-168 
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Magnetic tape, 

ANSI, 3-1 

mounting ANSI, 4-65 
Magnitude value, 4-81 
/MAIN keyword, 4-114 
Mapped system, 1-1 
Mask, 


protection, 3-2 


Master File Directory (MFD), 3- 


/MAXEXT keyword, 4-119 
/MAXPKT keyword, 4-112 
/MC, 5-11 
MCR, 
command file syntax, 
command summary, 4-6 
commands for RSX-11S, B-1 
indirect file processor, 
interface, 4-2 
messages, A-1 
messages for Basic MCR, 
prompt, 2-3, 2-7, 2-8 
syntax for Basic MCR, 
/MCR keyword, 4-100 
Memory, 
examining word of, 
modifying word of, 
Message at terminal, 
displaying, 4-24 
Messages, 
ACNT error, 2-22, 
Basic MCR error, 
MCR, A-1l 
TKTN, A-1l 
MFD, 3-2 
Mode, 
data, 5-21 
escape recognition, 
global symbol, 5-20 
lower-case, 5-20 
substitution, 5-20 
Modify option, 2-20 
Modifying account entries, 
2-20, 2-22 
Modifying word of memory, 
Monitor console interface, 
MOU, 4-65 
MOU keyword, 4-174 
Mount command, 2-16, 3-1, 4-65 
Mounting ANSI magnetic tape, 
4-66 
Mounting network channels, 
Mounting volume, 4-65 
Multiprogramming, 1-2 
Multiuser account file, 
creating, 2-18 
Multiuser protection commands, 
4-8 
ALLOCATE, 


5-11 


5-2 


B-1 
B-1 
4-165 


4-165 


2-23 
B-1 


5-20 


4-2 


2-17 


4-8, 4-16 


4-165 


4-71 
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Multiuser protection commands 

(Cont. ) 
BYE, 4-8, 
DEALLOCATE, 
HELLO, 4-8, 4-41 
HELP, 4-8, 4-46 

Multiuser protection system, 

2-13 

commands, 4-8 
default UIC in, 3-5 
functions of, 2-13 

/MXF keyword, 4-56 


N 


4-27 


4-8, 4-31 


Name, 
command, 4-9 
device-unit, 2-9, 3-3 
global logical, 2-13 
logical, 2-12 
login logical, 
task, 5-36 
Nested indirect command 
files, 5-2, 5-11 
Network channels, 
mounting, 4-71 
/NOCOLOG keyword, 4-122 
/NOCON keyword, 4-175 
/NOCOTERM keyword, 4-123 
/NOCRT keyword, 4-90 
/NOEBC keyword, 4-92 
/NOECHO keyword, 4-93 
/NOESCSEQ keyword, 4-93 
/NOFORMFEED keyword, 4-95 
/NOFDX keyword, 4-94 
/NOHHT keyword, 4-97 
/NOHOLD keyword, 4-98 
/NOLOGON keyword, 4-112 
/NOLOWER keyword, 4-99 
/NOMAIN keyword, 4~115 


2-13 


Nonprivileged, 

status, 2-15 

user, 2-6, 3-5 
/NOOVLP keyword, 4-101 
/NOPAR keyword, 4-118 


/NOPRIV keyword, 4-102 
/NOPUB keyword, 4-102 
/NOREMOTE keyword, 4-103 
/NORPA keyword, 4-104 
/NOSLAVE keyword, 4-105 
/NOSUB keyword, 4-117 
/NOTYPEAHEAD keyword, 4-108 
/NOVFILL keyword, 4-109 
/NOWCHK keyword, 4-110 
/NOWRAP keyword, 4-111 


Null device, 2-12 
Number, 
Logical Block (LBN), 4-146, 
4-173 


Number (Cont.) 
Logical Unit (LUN), 2-11 
Numeric constants, 5-9 
Numeric expressions, 5-9 
Numeric symbols, 5-5, 5-9,5-19, 
5-29, 5-33, 5-34, 5-36 


O 


-ONERR directive, 5-30 
OPE, 5-76 
OPEN directive, 5-31 
-OPENA directive, 5-31 
Open Register command, 4-165 
Operation, 

task, 1-2 

terminal, 2-1 
Optimizing I/O processing, 

4-112 

Option, 

backspace, 2-2 

delete, 2-21 

examine, 2-19 

list, 2-21 

modify, 2-20 

sort, 2-21 

switch, 3-4 
Output, 

resuming suspended, 2-3 

suspending terminal, 2-3, 2-5 
Output file, 3-3 


‘f/OVLP keyword, 4-100 


/OVR keyword, 4-69 
/OVREXP keyword, 4-70 
/OVRFSID keyword, 4-69 
Ownership, 

file, 3-1 


P 


PAR, 5-72 
Parameter command, 4-1 
/PAR keyword, 4-84, 4-117, 4-149, 
4-157, 4-165 
/PARM keyword, 4-70 
Partition, 1-1 
setting up, 4-114 
system-controlled, 1-1 
user-controlled, 1-1 
Partition definitions, 
displaying, 4-76 
Partition Definitions command, 
4-76 
Password, 2-14 
-PAUSE directive, 5-32 
Peripheral devices, 2-9, 2-10 
Peripheral Interchange Program 
(PIP), 3-2 
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/PMD keyword, 4-10, 4-11, 4-84, 
4-149 
Pool, 
setting size of dynamic, 
4-118 
/POOL keyword, 4-118 
Postmortem dump, 4-10 
/PRI keyword, 4-84, 4-138, 
4-149 
Priority, 1-2 
Priority directive, alter, 4-10 
Priority of task, 
altering running, 4-10 
altering static, 4-138 
/PRIV keyword, 4-101 
Private device, 2-16 
allocating, 4-16 
deallocating, 4-31 
Privilege, 
terminal, 2-6 
Privileged, 
user, 2-6, 2-15, 3-5 
status, 2-15 
/PRO keyword, 4-57, 4-132, 4-149 
Processor, 
Ancillary Control (ACP), 4-36, 
4-65 
MCR Irdirect File (AT.), 5-2 
Processor directives, 5-2 
Processor switches, 
indirect file, 5-10 
Program, 
account file maintenance 
(ACNT), 2-17 
File Exchange (FLX), 3-1 
Peripheral Interchange 


(PIP), 3-2 
SHUTUP, 2-23 
Prompt, 


default, 2-7, 4-2 

input, 2-7, 4-1, 4-2 

MCR, 2-3, 2-7, 2-8 

task, 2-7 
Protection, 

default file, 3-3 

file, 3-2 

multiuser, 2-13 
Protection mask, 3-2 
Protection UIC, 3-5 
/PRTCL keyword, 4-71 
Pseudo devices, 2-9, 2-11 

redirecting, 2-11, 2-12 
/PUB keyword, 4-102 
Public device, 2-16 


Q 


Queue entries, 
displaying clock, 4-143 
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R 
Rates, 
DH11 baud, 4-106 
DZ11 baud, 4-106 
/RCK keyword, 4-72 
REA, 4-168 
Reassign command, 4-168 
Reassigning device, 2-12 
Reassigning LUNs, 4-168 
RED, 4-169 
Redirect command, 4-169 
Redirecting, 
device, 2-12 
I/O requests, 4-169 
pseudo device, 2-11, 2-12 
/REG keyword, 4-144, 4-165, 
4-184 
REM, 4-171 
/REMOTE keyword, 4-103 
Remove command, 4-171 
Removing installed task, 4-171 
Requests, 
cancelling time-based 
initiation, 4-28 
RES, 4-79 
Rescheduling a task, 4-80 
Resume command, 4-79 
Resuming suspended output, 2-3 
Resuming suspended task, 4-79 
Resuming terminal display, 2-3 
RETURN, 2-2 
Return, 
carriage, 2-2 
-RETURN directive, 5-33 
Retyping current line, 2-5 
RKO5/RKO6 disk, 
write check for, 4-110 
/RON keyword, 4-144, 4-150, 4-184 
/ROPAR keyword, 4-84, 4-150 
/7RPA keyword, 4-104 
/RPRI keyword, 4-138 
/RSI keyword, 4-80 
RSX-11M/M-PLUS, 
shutting down, 2-23 
RSX-11S MCR commands, B-1l 
RT-11 format, 3-1 
RUN, 4-80 
Run command, 4-80 
Running a task, 4-80 
Running priority, 4-10 


S 


SAV, 4-172 

Save command, 4-172 

Saving system image, 4-172 
Secondary file, 5-31 

SET, 4-87 

Set command, 4-87 


.SETF directive, 5-33 
-SETN directive, 5-33 
-SETS directive, 5-34 
-SETT directive, 5-33 
Setting, 
current date, 4-130 
current time, 4-130 
default UIC, 4-108 
size of dynamic storage 
region, 4-118 
system-wide characteristics, 
4-87 
terminal characteristics, 
4-87 
terminal UIC, 3-5, 4-108 
Setting up partition, 4-114 
Setting up subpartition, M-PLUS, 
4-116 
/SFILE keyword, 4-174 
Shutting down RSX-11M/M-PLUS, 
2-23 
SHUTUP program, 2-23 
/SLAVE keyword, 4-105 
Slave terminal, 2-6, 4-105 
/SLV keyword, 4-84, 4-150 
Solicited input, 2-7 
Sort option, 2-21 
Sorting the account file, 2-21 
Special characters, 2-1 
Specifier, 
file, 3-3, 3-4, 5-1 
UIC, 2-14, 3-4 
Specifier defaults, 
file, 3-6 
Specifying a UFD, 3-3 
Specifying an indirect 
command file, 5-1 
/SPEED keyword, 4-106 
Standard file type, 3-6 
Status, 
nonprivileged, 2-15 
privileged, 2-15 
Status flags, 
task, 4-21 
Status of active tasks, 
displaying, 4-21 
Status of installed tasks, 
displaying, 4-127 
Status of known devices, 
displaying 4-32 
STD, 1-3, 4-146 
STD entry, temporary, 4-3 
Stop command, 4-126 
-STOP directive, 5-35 
Storage region (pool), 
setting size of dynamic, 4-118 
STP, 4-126 
String constants, 5-10 
String expressions, 5-10 
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String symbol value, 
substituting, 5-5 
String symbols, 5-9, 5-10 
String termination, command, 4-2 
/SUB keyword, 4-116 
Subpartition, 1-2 
setting up, 4-11 
Substituting string symbol 
value, 5-8 
Substitution mode, 5-20 
Substrings, 5-10 
Summary, 
Basic MCR command, B-1 
MCR command, 4-6 
Suspended task, 
resuming, 4-79 
Suspending indirect file 
processing, 5-36 
Suspending terminal output, 
2-3, 2-5 
Switch, 
default, 3-6 
Switch option, 3-4 
Switch Register command, 4-183 
Switch value, 3-5 
Switches, 
indirect file processor, 
SWR, 4-183 
Symbol mode, 
global, 5-20 
Symbol value substitution, 5-8 
Symbols, 5-5 
logical, 5-5, 5-6 
logical test of, 5-26 
numeric, 5-5, 5-7, 5-9 
special, 5-6 
string, 5-5, 5-7, 5-9 
/SYNC keyword, 4-150 
Syntax, 
Basic MCR, B-l 
command, 4-4 
MCR command file, 5-11 
System, 
file, 3-1 
mapped, 1-1 
multiuser protection, 2-13 
unmapped, 1-1 
System image, 
booting, 4-139 
saving, 4-172 
System maintenance commands, 4-7 
BRK, 4-7, 4-142 
BRO, 4-7, 4-24 
OPEN, 4-8, 4-165 
SAVE, 4-8, 4-172 
SSM, 4-8, 4-182 
SWR, 4-8, 4-183 
System Service Message command, 
4-182 
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SSM, 4-182 

System Task Directory (STD), 1-3, 
4-146 

System UIC, 4-113 

System-controlled partition, 1-1 

/SYSUIC keyword, 4-113 


T 


Tab, 
horizontal, 2-3 
vertical, 2-3 
TAB key, 2-3 
Table, 
logical device, 2-13 
TAL, 5-112 
Tape, 
ANSI magnetic, 3-1 
mounting ANSI magnetic, 4-66 
TAS, 4-128 
/TASK, 5-57 
Task, 1-1 
aborting a, 4-10 
active, 1-3 
altering running priority 
of, 4-138 
altering static priority 
of, 4-138 
AT. , 5-2 
dormant, 1-3 
freeing a fixed, 4-144 
installing a, 1-3, 4-146 
preparing a, 1-2, 1-3 
removing installed, 4-171 
rescheduling a, 4-80 
resuming suspended, 4-79 
running a, 4-80 
Task Control Block (TCB), 
Task control commands, 4-7 
ABORT, 4-7, 4-10 
ALTER, 4-7, 4-138 
CANCEL, 4-7, 4-28 
FIX, 4-7, 4-144 
REASSIGN, 4-7, 4-168 
REDIRECT, 4-7, 4-169 
REMOVE, 4-7, 4-171 
RESUME, 4-7, 4-79 
RUN, 4-7, 4-80 
STP, 4-7, 4-126 
UNFIX, 4-7, 4-184 
UNSTOP, 4-7, 4-134 
Task Directory, 
System (STD), 1-3, 4-146 
Task execution, 
terminating, 4-10 
Task extensions, 4-119 
Task in memory, 
fixing, 4-144 
/TASK keyword, 4-85, 4-151, 4-165 
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Task List command, 4-128 
Task List-ATL Format command, 
4-127 
Task names, 5-36 
Task-naming convention, 4-3 
Task operation, 1-2 
Task prompt, 2-7 
Task status flags, 4-21 
Task termination notification 
routine (TKTN), 4-10 
Taskname, 
assigning temporary, 4-85 
Tasks, 
displaying active, 4-14, 4-21 
displaying status of active, 
4-21 
displaying status of 
installed, 4-127 
TCB, 4-21, 4-146, 4-173 
/TEL keyword, 4-72 
Temporary STD entry, 4-3 
/TERM keyword, 4-5, 4-14, 4-106 
Terminal, 
attached, 2-6 
displaying message at, 4-24 
logging off, 2-13, 4-27 
logging onto, 2-13, 4-41 
slave, 2-6, 4-105 
types of operator, 4-8 
unattached, 2-6 


Terminal characteristics, 2-5 
setting, 4-87 
Terminal display, 
disabling, 2-3 
resuming, 2-3 
Terminal operation, 2-1 
Terminal output, 
suspending, 2-3, 2-5 
Terminal privilege, 2-6 
Terminal UIC, 
setting, 3-5, 4-108 
Terminating command strings, 4-2 
Terminating task execution, 4-10 
Terminator, 
line, 2-2, 2-5, 4-1 
-TEST directive, 5-36 
Test of symbols, 
logical, 5-26 
TIM, 4-130 
Time, 
setting current, 4-130 
Time command, 4-130 
Time interval, 4-80 
Time unit value, 4-80 
Time-based requests, 
cancelling initiation, 4-28 
TKTN, 4-10 
messages, A-l1 
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Tool, 
Executive Debugging, 4-140, 
4-142 
/TR, 5-11 
Type, 
file, 3-4 
standard file, 3-6 
/TYPEAHEAD keyword, 4-107 


U 


UCB, 4-146 
UFD, 3-1 
creating, 4-131 
specifying a, 3-3 
UFD command, 3-2, 4-131 
UIC, 2-14, 3-1, 3-5 
current, 3-5 
default, 3-5 
logon, 3-5 
owner, 3-2 
protection, 3-5 
setting default, 4-108 
setting terminal, 3-5, 4-108 
system, 4-113 
UIC in multiuser system, 
default, 3-5 
/UIC keyword, 4-58, 4-70, 4-80, 
4-85, 4-108, 4-151 
UIC specifier, 2-14, 3-5 
Unattached terminal, 2-6 
UNF, 4-184 
Unfix command, 4-184 
Unit Control Block (UCB), 4-146 
Unit Number, 
Logical (LUN), 2-11 
Unit value, , 
time, 4-80 
UNL, 4-185 
/UNL keyword, 4-70 
Unload command, 4-185 
Unmapped system, 1-1 
Unowned device, 2-16 
Unsolicited input, 2-7 
Unstop command, 4-134 


UNS, 4-134 
/USER keyword, 4-37 
User, 


nonprivileged, 2-6, 2-15, 3-5 
privileged, 2-14, 3-5 
User File Directory, 3-1, 4-131 
command, 4-131 
creating, 4-131 
User groups, 3-3 
User Identification Code 
(UIC), 2-14, 3-1, 3-5 
User-controlled partition, 1-1 
Utility, 
Bad block, 3-1 
Format, 3-1 
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; 
V W 
Value, WAIT directive, 5-36 
keyword, 4-3 : Wildcards, use of, 3-8 
magnitude, 4-81 
substituting string symbol, 
5-8 
switch, 3-4 
time unit, 4-80 X 
VCB, 4-36, 4-65 
Version, XDT, 4-140, 4-142 
default file, 3-6 -XQT directive, 5-37 
aan. ok 
ae 5s 
‘wee’ 
mae” 
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READER'S COMMENTS 


This form is for document comments only. DIGITAL will 
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